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

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

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

Поток задачи

1

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

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

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

Опрашивайте возвращённую задачу по соответствующему пути запроса изображений Kling, пока задача не достигнет конечного состояния.
3

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

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

Авторизации

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

Bearer token authentication. Use your CometAPI key.

Заголовки

Content-Type
string
по умолчанию:application/json

Must be application/json.

Тело

application/json
subject_image_list
object[]
обязательно

Subject reference images. Minimum 1, maximum 4.

Required array length: 1 - 4 elements
model_name
enum<string>
по умолчанию:kling-v2

Model to use for multi-image generation. Use kling-v2-1 for new requests; omitting the field uses the legacy route default.

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

Text prompt describing the desired output. Maximum 2500 characters.

negative_prompt
string

Elements to exclude from the image. Maximum 2500 characters.

scene_image
string

Optional scene reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

style_image
string

Optional style reference image. Image URL or raw Base64 string without a data: prefix. Supported formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.

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

Number of images to generate. Range: 1-9.

Требуемый диапазон: 1 <= x <= 9
aspect_ratio
enum<string>
по умолчанию:16:9

Aspect ratio of the generated image.

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

Watermark options.

callback_url
string

Webhook URL for task status notifications.

external_task_id
string

Optional user-defined task ID for your own tracking. Must be unique per account.

Ответ

200 - application/json

Task request accepted or an error response returned by the API.

code
обязательно

Response code. 0 means the task request was accepted.

message
string
обязательно

Response message.

data
object
обязательно
request_id
string

Request identifier returned when present.