创建 Kling Omni 图像任务
使用 CometAPI POST /kling/v1/images/omni-image,通过 Prompt 和参考图像输入创建 Kling Omni 图像任务。
task_id;请使用 获取 Kling Omni 图像任务 轮询任务,直至生成图像 URL 可用。
选择请求格式
- 单图生成:发送
prompt、image_list、resolution、result_type: single、n和aspect_ratio - 带水印输出:当需要在查询响应中获得带水印的结果 URL 时,添加
watermark_info.enabled: true - 模型 ID:省略
model_name以使用路由默认值,或发送经过测试的 Omni Image 模型 ID,例如kling-image-o1或kling-v3-omni
image_list 字段的 image 项。Prompt 可以按索引引用它们,例如第一个项使用 <<<image_1>>>,第二个项使用 <<<image_2>>>。
任务流程
创建任务
POST /kling/v1/images/omni-image 并存储返回的 data.task_id。查询任务
data.task_status 为 succeed 或 failed。持久化图像
data.task_result.images[].url 复制到您自己的存储中。结果字段
成功的查询响应会在data.task_result.images 下返回生成的图像。每个项可以包含:
授权
Bearer token authentication. Use your CometAPI API key.
请求头
Must be application/json.
请求体
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.