Kling Image 1.5

kling-v1-5-image Kling V1.5 Image поддерживает генерацию text-to-image и image-to-image для визуального создания и редактирования по промптам.

Эндпоинты

POST /v1/queue/kling-v1-5-image # Создать задачу

GET /v1/queue/kling-v1-5-image/requests/{request_id}/status # Проверить статус

GET /v1/queue/kling-v1-5-image/requests/{request_id}/response # Получить результат

PUT /v1/queue/kling-v1-5-image/requests/{request_id}/cancel # Отменить задачу

Параметры запроса

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v1-5-image' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A beautiful sunset landscape painting in impressionist style",
  "image_reference": "subject",
  "negative_prompt": "",
  "resolution": "1k",
  "n": 1,
  "aspect_ratio": "16:9",
  "image_fidelity": 0.5,
  "human_fidelity": 0.45,
  "watermark_info": {
    "enabled": false
  }
}'

prompt string required

Текстовый промпт, описывающий изображение для генерации.

Максимальная длина: 2500 символов.

image string

Референсное изображение. Передайте это поле, если нужно сгенерировать изображение на основе входного изображения. Не передавайте его для генерации по тексту.

Поддерживается доступный URL изображения или строка изображения в Base64.

Требования к изображению:

Форматы изображений: .jpg, .jpeg, .png.

Размер изображения не должен превышать 10MB. Ширина и высота изображения должны быть не менее 300px. Соотношение сторон должно быть от 1:2.5 до 2.5:1.

Требования к Base64:

При использовании Base64 передавайте только исходную строку Base64. Не добавляйте префиксы вроде data:image/png;base64,.

image_reference string

Тип референса изображения.

subject: референс характеристик персонажа

face: референс внешности персонажа

При использовании face загруженное изображение должно содержать только одно лицо.

Обязателен для Kling V1.5, если image не пустой.

Варианты: subject, face

negative_prompt string

Негативный текстовый промпт.

Максимальная длина: 2500 символов.

В запросах генерации по изображению, где передан параметр image, негативные промпты могут не поддерживаться.

n integer

Количество изображений для генерации.

По умолчанию: 1

Диапазон: 1 - 9

resolution string

Разрешение изображения.

Поддерживается только 1k

Варианты: 1k

По умолчанию: 1k

aspect_ratio string

Соотношение сторон выходного изображения.

Варианты: 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9

По умолчанию: 16:9

image_fidelity float

Управляет силой референса лица из загруженного пользователем изображения при генерации.

Чем выше значение, тем сильнее референс.

Диапазон: [0, 1]

По умолчанию: 0.5

human_fidelity float

Управляет сходством черт лица.

Доступен только когда image_reference=subject.

Диапазон: [0, 1]

По умолчанию: 0.45

watermark_info object

Генерировать ли результат с водяным знаком.

Задается параметром enabled:

"watermark_info": {
  "enabled": boolean
}

true: сгенерировать результат с водяным знаком

false: не генерировать результат с водяным знаком

Пользовательские водяные знаки не поддерживаются.

callback_url string

URL обратного вызова для изменений статуса задачи. Если он задан, сервер отправляет обновления задачи на этот URL.

external_task_id string

Пользовательский ID задачи. Он не заменяет системный ID задачи, но может использоваться для поиска задачи.

Значение должно быть уникальным для каждого пользователя.

Параметры ответа

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-v1-5-image/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-v1-5-image/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v1-5-image/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Поле	Тип	Описание
`request_id`	string	ID задачи, используемый для последующих операций.
`response_url`	string	URL для получения итогового результата.
`status_url`	string	URL для проверки статуса задачи.
`cancel_url`	string	URL для отмены задачи.
`queue_position`	int	Текущая позиция в очереди.

Следующие операции