Kling Image 4.0 Long Image 教程
用 Kling Image 4.0 Long Image 生成 2K 网页排版和电商详情页。含两次实测完整长图、cURL 请求、轮询下载流程与实时费率。
以 Markdown 阅读常规图像模型一次只能出一帧。真要用它们拼一整套商品详情页或品牌发布页,往往得硬生生生成五六张彼此割裂的横幅图,再在排版软件里反复调边距、对字体、修产品比例。Kling Image 4.0 Long Image 的思路完全不同:单次 API 请求直接返回一张从顶栏到页脚一气呵成的纵向 PNG,宽度固定为 1K(1024 px)或 2K(2048 px),高度则随着简报里的模块自然延伸。
2026 年 11 月 19 日,我们通过 SeedRouter 的 /v1/images/generations 接口实测跑了两个 2K 任务,分别用真实业务简报验证两种模式。第一次走纯文本 webpage 模式,为一个虚构的监听耳机品牌生成了 2048 × 16385 px 的发布页(17 MB,耗时 169 秒);第二次走 ecommerce 模式的 medium 档位,传入两张现成的珠宝照片,产出一张 2048 × 19533 px 的商品详情页(25 MB,耗时 261 秒)。下文展示了这两张长图的完整拼览,你也可以直接打开 Kling Image 4.0 Long Image Playground 试跑这两份简报,并在文末的实时价格表里核对各档费率。
动笔前,先确定用 ecommerce 还是 webpage
settings.skill 是必填字段,它既决定整页的版式语法,也直接约束接口允许传入的参数。把这两种模式当成两套独立的接口契约来看,而不要误以为只是视觉滤镜切换。
如果你手头已经有商品实拍图,需要做一张面向独立站或电商平台的纵向商品详情页(PDP),就选 ecommerce。该模式下,contents 里必须带上 1 至 3 条 refer_image,并通过 settings.length 控制整页模块深度(short、medium 或 long,默认 medium)。如果一张商品参考图都没传,请求会在计费前直接被拦截。
如果你要设计品牌落地页、新品发布站或编辑风网页,就选 webpage。网页模式下参考图是选填项:既可以纯文字直出,也可以最多配一张 style_refer_image 来定配色和栅格节奏,再配一张 subject_refer_image 锚定主推产品。注意不要在 webpage 模式下传入 refer_image 或 settings.length——这两项只属于 ecommerce 模式,混传会直接触发参数校验报错。
| 参数或输入 | ecommerce 模式 | webpage 模式 |
|---|---|---|
settings.skill | "ecommerce"(必填) | "webpage"(必填) |
settings.length | "short"、"medium"(默认)或 "long" | 完全省略 |
settings.resolution | "1k"(宽 1024 px)或 "2k"(宽 2048 px) | "1k"(宽 1024 px)或 "2k"(宽 2048 px) |
refer_image 条目 | 必填:1 至 3 个公开 JPEG/PNG URL | 不允许传入 |
style_refer_image / subject_refer_image | 不允许传入 | 选填:各最多 1 张 |
两种模式都不支持 4k、批量张数(n)或宽高比设置。每次成功执行的任务都会在 output.data[0].url 中返回唯一一张纵向 PNG 的地址。
实测 1:纯文本 2K 网页视觉长图(2048 × 16385)

上图把这次 webpage 2K 实测的整张长图按纵向四等分并排展开。简报要求为一款名为 S-01 Reference Planar 的开放式平板耳机设计瑞士工业风黑曜石深色发布页,依次包含极简顶栏、四分之三角度主视觉棚拍、三栏声学卖点带、CNC 精加工剖视图、带真实电声指标的技术规格表以及简洁页脚。
仔细看一遍单次直出保留下来的完成度:横跨 16,385 像素的纵向画布,深炭灰底色、衬线主标题和拉丝铝金属耳机的机身结构从顶栏一路稳到五色展示带与参数表。提示词里给出的所有电声参数全部清晰可读(106 mm Iso-Planar、32 Ohms、98 dB/mW、8 Hz–52 kHz、410 g)。放大到 100% 逐屏检查时,我们也发现一处小偏差:简报里要求参数表区域改用浅象牙白底色,但模型最终让参数表延续了深板岩底色,反而把浅灰背景用在了下方邮件订阅条上。如果前端还原时对某一段背景色切换有硬性要求,更稳妥的做法是把生成图当成整页视觉稿,再用其中高质量的局部摄影素材配合真实 HTML 重建该模块。
写好 webpage 简报,更像写一份带文案的线框大纲,而不是写单帧插画提示词。先在开头钉死全局设计语言(底色色号、表面材质、点缀色、栅格纪律),再按从上到下的顺序逐段编号,写明标题和关键数字。标题越含糊,画面里就越容易冒出无意义的占位假词。
curl --fail-with-body -sS 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 vertical flagship product launch webpage for SOLSTICE AUDIO introducing the S-01 Reference Planar open-back studio headphones. Visual language: Swiss minimalist editorial web design, matte obsidian slate (#0E1014), brushed titanium silver surfaces, amber-gold accents, sharp typography. (1) Minimal top bar with wordmark and Reserve button. (2) Hero with headline Silence, Machined. Precision, Amplified. and a three-quarter studio shot of CNC aluminum planar headphones. (3) Three-column highlights for 106 mm Iso-Planar Driver, Zero-Resonance Billet Frame, and Hand-Matched Pairs. (4) Macro exploded machining cutaway. (5) Technical specifications table listing Impedance 32 Ohms, Sensitivity 98 dB/mW, Frequency Response 8 Hz-52 kHz, and Weight 410 g. (6) Minimal studio footer."
}],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}' -o solstice-task.json
jq -er '.id' solstice-task.json留意这段请求体里没有写 settings.length,contents 也只放了一条 prompt。完整参数契约见 Kling Image 4.0 Long Image API 文档。[1]
实测 2:双参考图 2K 电商商品详情页(2048 × 19533)

第二次实测中,我们将 settings.skill 切到 "ecommerce",settings.length 设为 "medium",resolution 保持 "2k",并在 refer_image 里传入两张现成的珠宝摄影图:一张雕塑感黄金兰花垂坠耳环微距特写,标记为 id: "earring";另一张玻璃温室中佩戴同款耳环的杂志风人像,标记为 id: "model"。
在提示词里,我们直接在对应模块的描述中用 @earring 和 @model 调用这两张素材。接口会自动把命名 ID 映射到对应的参考图位置,省去了手动数序号的麻烦。所有参考图都必须是公开可访问的 JPEG 或 PNG URL,单张不超过 30 MB,单边至少 300 px,宽高比位于 2:5 至 5:2 之间。

这一次中版 2K 请求直接生成了 19,533 像素的纵向长图,完整覆盖六个电商模块:香槟丝绸底色首屏主视觉、设计灵感文案带、白底棚拍抠图配六行商品信息表(Phalaenopsis No. 4 Drop Earring、18K Recycled Yellow Gold、48 mm drop length、Forest-green velvet presentation box)、忠实还原 @model 的 On The Ear 佩戴人像、六视角细节九宫格(Front、Side、Back、Core Detail、Hook Detail、Profile),以及上方放大的 Craft And Beauty 工艺剖析标注图。
100% 放大核验时,我们也抓到了一个上线前必须留意的典型问题:规格表里的完整品名 Phalaenopsis No. 4 Drop Earring 以及所有工艺标注文字都拼写准确,但顶部首屏横幅把原本要求的 L'ORCHIDÉE 和 Botanical Series 缩写成了 BOTA SERIES 与 BOTA — Drop Earring。这在长图文字渲染中并不罕见——规格表短词和注释标签通常很稳,但高度风格化的全大写品牌主标偶尔会走样。上线前一定要拉到原图宽度复查首屏大字,涉及法定品牌 Logo、价格或合规小字,最好留到商城模板里用矢量图层叠加。
curl --fail-with-body -sS 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": "Create a luxury fine-jewelry ecommerce product detail page keeping exact fidelity to the brushed gold orchid earring in @earring and the editorial portrait in @model. Alternate warm champagne silk, alabaster ivory, and dark conservatory tones. (1) Hero product showcase on warm silk. (2) Design inspiration band. (3) Clean product info table listing Phalaenopsis No. 4 Drop Earring, 18K Recycled Yellow Gold, 48 mm drop length, Forest-green velvet presentation box. (4) On-the-ear editorial portrait using @model. (5) Six-angle product detail grid. (6) Annotated Craft And Beauty callout diagram highlighting Hand-Chased Petals, Satin Gold Finish, and Balanced Wire Hook."
},
{
"type": "refer_image",
"id": "earring",
"url": "https://example.com/assets/gold-orchid-earring.png"
},
{
"type": "refer_image",
"id": "model",
"url": "https://example.com/assets/editorial-portrait.png"
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}' -o orchidee-task.json
jq -er '.id' orchidee-task.json如果改在 webpage 模式下传参考图,记牢分工即可:用 style_refer_image 控制整体美学风格,用 subject_refer_image 锚定主推单品,给每张图起一个独一无二的字母数字 id(1 至 32 个字符,不能含空格),再在提示词里用 @id 提及。同一个 contents 数组内切勿出现重复的 id。
耐心轮询,并为大体积 2K PNG 留足下载缓冲
纵向长图比普通单图耗时明显更久,产出的文件也重得多。如果沿用五秒级缩略图接口的超时习惯,极易触发客户端断连甚至误重试导致重复扣费。
11 月 19 日的两次实测中,2048 × 16385 网页耗时 169 秒(文件 17 MB),2048 × 19533 中版电商详情页耗时 261 秒(文件 25 MB);如果是 long 档位的 2K 电商长图,耗时会超过七分钟,文件体积也可能突破 50 MB。收到 POST /v1/images/generations 返回的任务 ID 后请立即持久化,每隔 15 至 20 秒轮询一次 GET /v1/tasks/{id},切勿因为终端断线或请求超时就贸然重发第二次 POST。[2]
TASK_ID=$(jq -er '.id' orchidee-task.json)
curl --fail-with-body -sS "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $SEEDROUTER_API_KEY" -o orchidee-result.json
jq -r '.status' orchidee-result.json当 status 变为 completed 时,从 output.data[0].url 取出单张 PNG 地址,并设置充足的传输超时将其流式写入磁盘:
IMG_URL=$(jq -er 'select(.status == "completed") | .output.data[0].url' orchidee-result.json)
curl --fail -L --max-time 300 "$IMG_URL" -o orchidee-2k.png在服务端 Worker 里处理这类大文件时,不要把整张 PNG 一次性读进固定上限的内存缓冲区。更稳妥的做法是把 HTTP 响应流直接落盘或推送到对象存储,先读取实际像素尺寸,再按移动端店铺规范横向切片,展示预览转为 WebP,仅把原始 PNG 留作高清归档或切图源。
八个输出档位与参考图计费策略
Kling Image 4.0 Long Image 的费用由三项选择决定:skill(ecommerce 或 webpage)、length(电商模式下的 short、medium 或 long)以及 resolution(1k 或 2k)。每一张输入参考图(refer_image、style_refer_image 或 subject_refer_image)均按单张加收输入费,从第 1 张起算,不含免费额度。
这样的计费结构让试稿和出图策略非常清晰。制作电商详情页时,先用 1k 搭配 short 或 medium 反复打磨模块顺序、标题节奏和色彩层次,确认纵向叙事通顺后再切 2k 出终稿。做网页设计时,1k 和 2k 的价差不大,只要页面包含细小字号的技术参数表,直接上 2k 通常更省事。本次实测中,第一笔任务按 webpage 2K 档位结算,第二笔按 ecommerce medium 2K 档位加 2 张参考图结算。失败的请求不扣费。你可以查阅下方的实时费率表,或直接前往 Kling Image 4.0 Long Image 价格计算器 核算自己的配置。[3]
Kling Image 4.0 Long Image 计费标准
| 类别 | 价格 (USD) |
|---|---|
| 电商详情页 · 1K · short | US$0.2269 |
| 电商详情页 · 2K · short | US$0.2723 |
| 电商详情页 · 1K · medium | US$0.4538 |
| 电商详情页 · 2K · medium | US$0.5294 |
| 电商详情页 · 1K · long | US$0.7563 |
| 电商详情页 · 2K · long | US$0.8319 |
| 网页设计 · 1K | US$0.5294 |
| 网页设计 · 2K | US$0.5748 |
| 参考图 | US$0.003025 |
常见问题
ecommerce 模式下怎么选 short、medium 和 long?
先数清商品真正需要几个独立模块,再选 length。short 适合三到四个紧凑区块,比如首屏主图、核心卖点和精简规格卡;medium 能从容容纳六个模块,正如上面的珠宝实测(首屏、设计故事、白底图与参数表、场景佩戴、多角度细节网格、工艺标注图);long 则留给数码硬件或多 SKU 商品,需要放下对比表、分步使用指南和包装清单,又不想把文字挤得太满。
为什么我的 webpage 请求返回了 HTTP 400?
最常见的两个校验错误,是在 skill: "webpage" 时多传了 settings.length,或者把参考图的 type 写成了 refer_image 而不是 style_refer_image / subject_refer_image。这两个字段都只属于 ecommerce 模式。此外请检查提示词是否在加权字符上限内(按 @id 映射后校验 en / 166000 + non_en / 71000 <= 1),以及 resolution 是否填写了 "1k" 或 "2k"。
线上商城上线前,需要把成品 PNG 切图吗?
需要。一张 2048 × 19533 的未压缩 PNG 足有 17 到 25 MB,直接塞进单个 <img> 标签在移动网络下根本拖不动。上线前请沿水平模块分界线切开,把每一段压成 WebP 或 AVIF 以支持渐进加载,并将法定商标、实时售价与购买按钮替换成真正的 HTML 文本。搭建自动化管线之前,你可以先在 Kling Image 4.0 Long Image Playground 里调试提示词并全尺寸预览长图效果。



