Create a Kling Omni image task
Use CometAPI POST /kling/v1/images/omni-image to create Kling Omni Image tasks with prompt and reference-image inputs.
task_id; use Get a Kling Omni image task to poll the task until the generated image URLs are available.
Choose the request shape
- Single-image generation: send
prompt,image_list,resolution,result_type: single,n, andaspect_ratio - Watermarked output: add
watermark_info.enabled: truewhen you need a watermarked result URL in the query response - Model ID: omit
model_nameto use the route default, or send a tested Omni Image model ID such askling-image-o1orkling-v3-omni
image_list items with an image field. The prompt can cite them by index, such as <<<image_1>>> for the first item and <<<image_2>>> for the second item.
Task flow
Query the task
data.task_status is succeed or failed.Result fields
Successful query responses return generated images underdata.task_result.images. Each item can include:
| Field | Description |
|---|---|
index | Position of the generated image in the task result. |
url | Generated image URL. |
watermark_url | Watermarked image URL when watermark output is requested. |
Authorizations
Bearer token authentication. Use your CometAPI API key.
Headers
Must be application/json.
Body
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.
Optional model ID for this Omni Image request. Omit this field to use the route default.
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.
Requested output resolution. Use 1k, 2k, or 4k; omitted requests use 1k.
1k, 2k, 4k Use single for a single-image task.
single Number of single-image results to generate. Range: 1 to 9.
1 <= x <= 9Requested 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 options. When enabled is true, the task can return watermarked result URLs in addition to the original result URLs.
Webhook URL that receives task status notifications when the task status changes. Omit this field to poll manually.
User-defined task ID for your own tracking. It does not replace the system-generated task_id and must be unique per account.