Skip to main content
POST
cURL
Використовуйте цю кінцеву точку для створення асинхронного завдання Kling Omni Image через CometAPI. Запит на створення повертає task_id; використовуйте Отримання завдання Kling Omni Image щоб опитувати завдання, доки не стануть доступними URL-адреси згенерованих зображень.
Повний довідник параметрів постачальника див. у документації Kling Image O1.

Виберіть форму запиту

  • Генерація одного зображення: надішліть prompt, image_list, resolution, result_type: single, n і aspect_ratio
  • Вихідні дані з водяним знаком: додайте watermark_info.enabled: true, якщо вам потрібна URL-адреса результату з водяним знаком у відповіді на запит
  • Ідентифікатор моделі: не вказуйте model_name, щоб використати значення маршруту за замовчуванням, або надішліть протестований ідентифікатор моделі Omni Image, наприклад kling-image-o1 або kling-v3-omni
Для еталонних зображень використовуйте елементи 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 до власного сховища, якщо вам потрібен довготривалий доступ.
Повну схему відповіді та відомості про статус завдання див. у розділі Отримання завдання Kling Omni Image. Наступний запит один раз перевіряє одне завдання:

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

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

Авторизації

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.

Останнє оновлення 31 липня 2026 р.