Перейти к основному содержанию
POST
/
kling
/
v1
/
images
/
generations
Multi-Image to Image
curl --request POST \
  --url https://api.cometapi.com/kling/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subject_image_list": [
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    },
    {
      "subject_image": "https://filesystem.site/cdn/20250814/goDW44JIf6eSuxAS7TNringhWjO9kW.png"
    }
  ]
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Используйте этот endpoint, когда хотите, чтобы Kling сгенерировал одно изображение на основе нескольких референсов объекта и, при необходимости, дополнительных референсов сцены или стиля.

​
Перед вызовом

  • Укажите от 2 до 4 изображений в subject_image_list
  • Используйте model_name: kling-v2
  • Добавляйте scence_image или style_image только тогда, когда базовая композиция объекта уже работает
  • Рассматривайте это как асинхронный маршрут генерации и сохраните возвращённый id задачи

​
Поток задачи

1

Отправьте задачу генерации изображения

Отправьте список изображений объекта и prompt, затем сохраните возвращённый id задачи.
2

Опрашивайте задачу

Продолжайте с Individual Queries, используя путь запроса изображений Kling, пока задача не достигнет терминального состояния.
3

Сохраните результат

Сохраните сгенерированное изображение в собственное хранилище, если вам нужен долговременный доступ.
Полное описание параметров см. в официальной документации Kling.

Авторизации

​
Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Заголовки

​
Content-Type
string

Content type of the request body.

Тело

application/json

Kling Image Generation API request body definition

​
subject_image_list
object[]
обязательно

List of subject reference images. Minimum 2, maximum 4.

​
model_name
enum<string>
по умолчанию:kling-v2

Model to use for multi-image generation.

Доступные опции:
kling-v2
​
prompt
string

Text prompt describing the desired output. Max 2500 characters.

​
scence_image
string

Optional scene reference image. Same format and size constraints as subject images.

​
style_image
string

Optional style reference image. Same format and size constraints as subject images.

​
n
integer
по умолчанию:1

Number of images to generate.

​
aspect_ratio
enum<string>
по умолчанию:16:9

Aspect ratio of the generated image (width:height).

Доступные опции:
16:9,
9:16,
1:1,
4:3,
3:4,
3:2,
2:3,
21:9
​
callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

​
external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Ответ

200 - application/json

Successful Response

​
code
integer

Error code; specifically define the error code

​
message
string

error message

​
request_id
string

Request ID, system-generated, for tracking requests, troubleshooting issues

​
data
object