Image
Kling Image 4.0
使用 Kling Image 4.0 创作 2K 或 4K 图像。通过命名参考图、单图变体或连续系列进行创作,然后轮询获取生成完成后的图像 URL。
向 POST /v1/images/generations提交 JSON 请求,模型 ID 为 kling-image-4-0。保存返回的任务 ID。该端点同时支持纯文本创作说明和参考图引导的创作说明。
快速示例
此请求会生成一张方形 2K 单图。请将 API 密钥存储在 SEEDROUTER_API_KEY环境变量中。
curl https://api.seedrouter.ai/v1/images/generations \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"model": "kling-image-4-0",
"contents": [
{"type": "prompt", "text": "Photograph an amber glass teapot on blue slate, lit through its handle by the morning sun."}
],
"settings": {"resolution": "2k", "aspect_ratio": "1:1"}
}'端点与请求头
POST https://api.seedrouter.ai/v1/images/generations 端点接收 JSON,请设置 Content-Type: application/json 和 Authorization: Bearer YOUR_API_KEY。请将密钥保存在服务器上。
参数
| 字段 | 类型 | 可选值与默认值 |
|---|---|---|
model | 字符串,必填 | kling-image-4-0 |
contents | 数组,必填 | 一个提示词和 0 到 10 张参考图。 |
contents[].type | 字符串,必填 | prompt或 refer_image。 |
contents[].text | 字符串 | 提示词必填。英文最多 50,000 个字符,非英文最多 21,000 个字符。混合文本中,英文和非英文内容分别占各自上限的比例相加不得超过 1。 |
contents[].url | 字符串 | 每张参考图均必填。请使用可公开访问的 HTTP(S) URL,图片格式为 JPEG 或 PNG,且文件大小不超过 30 MB。宽和高均须至少为 300 像素,宽高比须介于 2:5 和 5:2 之间。 |
contents[].id | 字符串 | 参考图的可选唯一名称。在提示词中使用 @name提及该名称。 |
settings.result_type | 字符串 | 独立图像使用 single(默认值),相关图像使用 series。 |
settings.n | 整数 | 生成 1–9 张独立图像。默认值为 1。仅在 single 模式下使用。 |
settings.series_amount | 整数或字符串 | series 模式下生成 2–10 张图像,默认值为 4。对于 5–10 张图像,提示词最多支持 20,000 个字符,并且必须按名称提及每个参考对象。每个参考对象都必须清晰可读,且大小不得超过 20 MB。在 single 模式下会忽略此字段,可填 2 到 10 的整数或字符串 auto。 |
settings.resolution | 字符串 | 2k(默认值)或 4k。 |
settings.aspect_ratio | 字符串 | auto(默认值)、16:9、9:16、1:1、4:3、3:4、3:2、2:3或 21:9。 |
options.watermark_info.enabled | 布尔值 | 可选。仅支持 false。 |
根据一张参考照片生成连续系列
将示例 URL 替换为可公开访问的产品照片 URL。此示例请求生成三张连续图像。请将每一帧的说明写在同一个提示词中。
{
"model": "kling-image-4-0",
"contents": [
{"type": "refer_image", "url": "https://example.com/lamp.jpg", "id": "lamp"},
{"type": "prompt", "text": "Three shots of @lamp in the same studio. Start with a wide view of the workbench, move to the brass shade, then finish on the warm reflection of the bulb in the desk."}
],
"settings": {"result_type": "series", "series_amount": 3, "resolution": "4k", "aspect_ratio": "3:2"}
}获取所有图像
将 POST 响应中的 id复制到 TASK_ID。使用同一密钥轮询此端点,直到任务状态变为 completed或 failed。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"任务完成后,读取 output.data[].url中的所有 URL。一个任务可能返回多张图像。如果状态查询中断,请用原始 ID 再次查询。生命周期说明请参阅任务参考,错误代码请参阅错误目录。
价格
总费用 = 按请求分辨率生成的图像数量 × 当前图像生成费率 + 每张输入参考图对应的一笔参考图费用。生成 4 张 4K 图像并使用 2 张参考图,费用为 4 笔 4K 图像生成费用和 2 笔参考图费用。请求失败不收费。请参阅当前费率。
错误与使用提示
输入无效时会返回请求错误。请检查是否缺少提示词、参考图 ID 是否重复,以及分辨率或系列设置是否受支持。如果首次调用已返回任务 ID,请先查询该 ID,再判断是否需要重新提交。
对于包含多张参考图的创作说明,请为每个主体指定不同名称,并告诉模型每张参考图提供哪些视觉特征。在提示词中写明镜头指示和镜头顺序。请参阅Kling Image 4.0 Playground和 OpenAPI 架构。
