v1

latestOpenAPI 3.1.02026-07-267724480.0 KB

Create a Kling Omni image task

Create an asynchronous Kling Omni Image task. Poll GET /kling/v1/images/omni-image/{task_id} until the task reaches a terminal state.

post/kling/v1/images/omni-image

Headers

Content-Typestring

Must be application/json.

Request body

model_namestring

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

promptstring required

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.

resolution'1k' | '2k' | '4k'

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

result_type'single'

Use single for a single-image task.

ninteger

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

aspect_ratio'16:9' | '9:16' | '1:1' | '4:3' | '3:4' | '3:2' | '2:3' | '21:9' | 'auto'

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

callback_urlstring uri

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

external_task_idstring

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

Response

Task accepted.

codeinteger required

Response code. 0 means the task request was accepted.

messagestring required

Response message.

request_idstring

Request identifier returned by CometAPI when present.