Image
Kling Image 4.0 Long Image
使用 Kling Image 4.0 Long Image 生成 1K 或 2K 电商商品详情页与网页视觉设计长图,再通过轮询获取最终的 PNG URL。
向 POST /v1/images/generations 提交 JSON 请求,模型 ID 填写 kling-image-4-0-long-image。保存返回的任务 ID,随后轮询 GET /v1/tasks/{id},直至单张纵向 PNG 生成完成。
快速示例
此请求会根据文字简报生成一张 1K 网页视觉版面。请将 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-long-image",
"contents": [
{"type": "prompt", "text": "Design a tall landing page for a specialty coffee roastery with a hero banner, three single-origin bean cards, roasting notes, and store hours."}
],
"settings": {"skill": "webpage", "resolution": "1k"}
}'端点与请求头
向 POST https://api.seedrouter.ai/v1/images/generations 发送 JSON 请求,并携带 Content-Type: application/json 与 Authorization: Bearer YOUR_API_KEY。请务必将密钥保存在服务端。
参数说明
| 字段 | 类型 | 取值与默认值 |
|---|---|---|
model | string,必填 | kling-image-4-0-long-image |
contents | array,必填 | 1 项 prompt 加对应模式允许的参考图条目。 |
contents[].type | string,必填 | prompt、refer_image(仅 ecommerce 模式,必填 1–3 张)、style_refer_image(仅 webpage 模式,最多 1 张)或 subject_refer_image(仅 webpage 模式,最多 1 张)。不支持 element。 |
contents[].text | string | prompt 项必填。纯英文上限 166,000 字符,纯非英文上限 71,000 字符;中英混排须满足 english / 166000 + non_english / 71000 <= 1。 |
contents[].url | string | 每项图片条目必填。公开可访问的 HTTP(S) JPEG 或 PNG URL,单张不超过 30 MB,单边至少 300 px,宽高比须在 2:5 至 5:2 之间。 |
contents[].id | string | 选填,在同一次请求的所有图片条目中保持唯一。可在提示词中通过 @id 引用。 |
settings.skill | string,必填 | ecommerce(电商商品详情页)或 webpage(网页视觉设计)。 |
settings.length | string | short(约 2–5 个模块)、medium(默认,约 6–10 个模块)或 long(约 11–18 个模块)。仅适用于 ecommerce 模式;webpage 模式下请省略。 |
settings.resolution | string | 1k(默认,宽 1024 px)或 2k(宽 2048 px)。纵向高度随内容自适应。不支持 4k。 |
options.watermark_info.enabled | boolean | 选填,目前仅支持 false。 |
电商商品详情页
电商模式必须提供 1 至 3 项 refer_image,并在提示词中通过各自设置的 id 引用对应商品照。
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "refer_image", "url": "https://example.com/kettle-front.png", "id": "front"},
{"type": "refer_image", "url": "https://example.com/kettle-spout.jpg", "id": "spout"},
{"type": "prompt", "text": "Build an ecommerce product detail page for the gooseneck kettle in @front with a close-up section highlighting @spout. Include hero visual, temperature control callouts, brewing scenes, and care notes."}
],
"settings": {"skill": "ecommerce", "length": "medium", "resolution": "2k"}
}搭配风格与主体参考图的网页设计
网页模式可选填 style_refer_image(最多 1 张)与 subject_refer_image(最多 1 张)。使用网页模式时请省略 settings.length。
{
"model": "kling-image-4-0-long-image",
"contents": [
{"type": "style_refer_image", "url": "https://example.com/editorial-grid.png", "id": "layout"},
{"type": "subject_refer_image", "url": "https://example.com/watch.jpg", "id": "watch"},
{"type": "prompt", "text": "Design a watch launch webpage matching the typography and grid rhythm of @layout while showcasing @watch across the hero, movement breakdown, and spec table."}
],
"settings": {"skill": "webpage", "resolution": "2k"}
}获取生成的长图
将 POST 响应中的 id 赋值给 TASK_ID,持续轮询直至状态变为 completed 或 failed。长图任务通常需要数分钟,尤其是 long 搭配 2k 的版面。
curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY"任务完成后,从 output.data[0].url 读取图片地址。每次请求都会返回一张完整的纵向 PNG;2k 长图体积可能超过 50 MB,请相应调大下载超时时间并做好预览缩放处理。更多细节请参阅任务接口参考与错误码目录。
计费规则
每次成功完成的请求会收取一次输出档位费(ecommerce 按 resolution × length 计费,webpage 按 resolution 计费),并按每张输入参考图(从第 1 张起算)加收参考图费用。请求失败不收费。查看当前实时费率。
常见报错与使用建议
非法参数会在计费前直接返回 HTTP 400。常见校验错误包括:遗漏 settings.skill、在 ecommerce 模式下未提供 1–3 个 refer_image URL、在 webpage 模式下混入 refer_image、请求不支持的 4k 分辨率,以及参考图 id 重复。
建议在提示词中按从首屏横幅到参数表或页脚的精确顺序写明模块结构,并仅填写已核实的产品参数,避免生成失真内容。欢迎前往 Kling Image 4.0 Long Image Playground 在线调试,或查阅 OpenAPI 规范。
