Claude Opus 5.5 已在 SeedRouter 上线

Image

Kling Image 4.0

View Markdown

使用 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 架构。