Skip to main content
POST
cURL
Використовуйте цей endpoint, щоб створити асинхронну задачу Kling Omni Image через CometAPI. Запит на створення повертає task_id; використовуйте Отримання задачі зображення Kling Omni, щоб опитувати задачу, доки 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
Референсні зображення використовують елементи 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. Наведений нижче короткий приклад опитує одну задачу, доки вона не досягне кінцевого стану:

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

Успішні відповіді запиту повертають згенеровані зображення в 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.