Skip to main content
POST
cURL
Используйте этот endpoint, чтобы создать асинхронную задачу Kling Omni Image через CometAPI. Запрос на создание возвращает task_id; используйте Get a Kling Omni image task, чтобы опрашивать задачу, пока не станут доступны URL сгенерированных изображений.
Полное справочное описание параметров провайдера см. в документации Kling Image O1.

Выберите форму запроса

  • Генерация одного изображения: отправьте prompt, image_list, resolution, result_type: single, n и aspect_ratio
  • Вывод с водяным знаком: добавьте watermark_info.enabled: true, если вам нужен URL результата с водяным знаком в ответе запроса
  • Model ID: не указывайте model_name, чтобы использовать значение маршрута по умолчанию, или передайте протестированный model ID Omni Image, например kling-image-o1 или kling-v3-omni
В качестве reference images используются элементы image_list с полем image. Prompt может ссылаться на них по индексу, например <<<image_1>>> для первого элемента и <<<image_2>>> для второго.

Поток задачи

1

Создать задачу

Отправьте POST /kling/v1/images/omni-image и сохраните возвращённый data.task_id.
2

Запросить задачу

Выполняйте опрос GET /kling/v1/images/omni-image/, пока data.task_status не станет succeed или failed.
3

Сохранить изображения

Когда задача будет успешно завершена, скопируйте data.task_result.images[].url в своё хранилище, если вам нужен долговременный доступ.
Полную схему ответа и примеры опроса см. в Get a Kling Omni image task. Следующий короткий пример опрашивает одну задачу, пока она не перейдёт в терминальное состояние:

Поля результата

Успешные ответы запроса возвращают сгенерированные изображения в data.task_result.images. Каждый элемент может включать: URL сгенерированных ресурсов могут истекать или удаляться сервисом провайдера. Сохраняйте готовые изображения в собственном слое хранения, если вашему workflow требуется длительное хранение.

Авторизации

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

Bearer token authentication. Use your CometAPI API key.

Заголовки

Content-Type
string

Must be application/json.

Тело

application/json
prompt
string
обязательно

Text prompt for the generated image. The prompt can reference images with <<<image_1>>>, <<<image_2>>>, and matching indexes from image_list. Maximum length is 2,500 characters.

model_name
string

Optional model ID for this Omni Image request. Omit this field to use the route default.

image_list
object[]

Reference images that the prompt can cite with <<<image_1>>>, <<<image_2>>>, and so on. Keep the total number of reference images within the provider limits for the selected model.

resolution
enum<string>
по умолчанию:1k

Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.

Доступные опции:
1k,
2k,
4k
result_type
enum<string>
по умолчанию:single

Use single for a single-image task.

Доступные опции:
single
n
integer
по умолчанию:1

Number of single-image results to generate. Range: 1 to 9.

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

Requested output aspect ratio in width:height format. Use auto to let the provider choose from the prompt and references.

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

Watermark options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.

callback_url
string<uri>

Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.

external_task_id
string

User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.

Ответ

200 - application/json

Task accepted.

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

Response code. 0 means the task request was accepted.

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

Response message.

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

Request identifier returned by CometAPI when present.