使用 Kling 生成图像
通过 CometAPI 使用 Kling 生成图像:POST /kling/v1/images/generations 支持基于 prompt 的图像创建和基于图像参考的生成。
图像生成
首次请求
从model_name: kling-v3、prompt、n 和 aspect_ratio 开始。仅在首次请求返回可用任务后,再添加参考图像、保真度控制或高级字段。省略 model_name 会使用旧版兼容默认值,因此对于新的集成,请显式传入 kling-v3。
读取响应
保存返回的task_id,然后轮询对应的 Kling 图像查询路由,直到 task_status 到达终态。如果你的工作流需要持久化存储,请在生成完成后将最终资源复制到你自己的存储层中。授权
Bearer token authentication. Use your CometAPI key.
请求头
Must be application/json.
请求体
Text prompt describing the image to generate. Maximum 2500 characters.
Kling image model variant. Use kling-v3 for new requests. Omitting model_name uses the legacy CometAPI route default.
kling-v1, kling-v1-5, kling-v2, kling-v2-1, kling-v3 Elements to exclude from the image. Maximum 2500 characters. Not supported when image is provided.
Reference image as a raw Base64 string without a data: prefix, or a public URL. Accepted formats: JPG, JPEG, PNG. Maximum 10 MB, minimum 300x300 px, aspect ratio between 1:2.5 and 2.5:1.
Reference mode for legacy image-to-image requests when image is provided.
subject, face How closely the output follows the reference image. Range: 0-1. Used by legacy image-reference models.
0 <= x <= 1Human-subject fidelity control. Range: 0-1. Used only by legacy subject-reference requests.
0 <= x <= 1Optional Kling element references. The total count of element references and input images must not exceed 10.
Output resolution. Defaults to 1k.
1k, 2k Number of images to generate. Range: 1-9.
1 <= x <= 9Output aspect ratio (width:height).
16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 Watermark options.
Webhook URL to receive task status updates when the task completes.
Optional user-defined task ID for your own tracking. Must be unique per account.