Kling V2.0 Multi Image to Image

kling-v2-multi-image2image Kling V2.0 Multi Image to Image использует несколько референсных изображений для контроля субъекта, сцены и стиля при создании нового изображения.

Примечание к API

Генерация изображений Kling V2.0 по нескольким референсам поддерживает только разрешение 1k.

Эндпоинты

POST /v1/queue/kling-v2-multi-image2image # Создать задачу

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

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

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

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

curl --request 'POST' 'https://api.odirouter.ai/model/v1/queue/kling-v2-multi-image2image' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A woman in a flowing red dress on the grassland, in Ghibli style.",
  "subject_image_list": [
    {
      "subject_image": "https://www.gstatic.com/webp/gallery/1.jpg"
    },
    {
      "subject_image": "https://www.gstatic.com/webp/gallery/2.jpg"
    }
  ],
  "scene_image": "https://www.gstatic.com/webp/gallery/3.jpg",
  "style_image": "https://www.gstatic.com/webp/gallery/4.jpg",
  "n": 1,
  "aspect_ratio": "16:9"
}'

prompt string

Положительный текстовый промпт.

Не должен превышать 2500 символов.

subject_image_list array required

Список референсных изображений субъекта. Поддерживается от 1 до 4 изображений; каждое изображение передается как URL или строка Base64 через ключ subject_image:

"subject_image_list": [
{ "subject_image": "image_url_or_base64" },
{ "subject_image": "image_url_or_base64" }
]

На стороне API кадрирование не выполняется; загружайте изображения, где субъект уже подготовлен нужным образом

Поддерживаются изображения в Base64 или URL изображений (должны быть публично доступны)

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

Поддерживаемые форматы: .jpg / .jpeg / .png

Размер файла не должен превышать 10MB; ширина и высота должны быть не менее 300px; соотношение сторон должно быть от 1:2.5 до 2.5:1

subject_image string required

URL изображения субъекта или сырая строка Base64

scene_image string

Необязательное референсное изображение сцены.

Поддерживается изображение в Base64 или URL изображения (должен быть публично доступен)

Поддерживаемые форматы: .jpg / .jpeg / .png

style_image string

Необязательное референсное изображение стиля.

Поддерживается изображение в Base64 или URL изображения (должен быть публично доступен)

Поддерживаемые форматы: .jpg / .jpeg / .png

n integer

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

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

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

aspect_ratio string

Соотношение сторон сгенерированного изображения (ширина:высота).

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

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

watermark_info object

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

enabled boolean

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

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

callback_url string

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

external_task_id string

Пользовательский ID задачи.

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

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

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

{
  "request_id": "task_01hxyz...",
  "response_url": "https://api.odirouter.ai/model/v1/queue/kling-v2-multi-image2image/requests/task_01hxyz.../response",
  "status_url": "https://api.odirouter.ai/model/v1/queue/kling-v2-multi-image2image/requests/task_01hxyz.../status",
  "cancel_url": "https://api.odirouter.ai/model/v1/queue/kling-v2-multi-image2image/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	Текущая позиция в очереди.

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