· reAPI Team
Kling Image 4.0 Long Image 教程
了解如何在 reAPI 上使用 Kling Image 4.0 Long Image 制作电商详情页与网页布局,涵盖模式规则、参考图 ID、计费说明与审图步骤。

大多数图像生成器每次只能输出一张方形或 16:9 画面。当你需要完整的电商商品详情页或连续的竖向落地页时,把六张独立静态图拼接在一起几乎总会让光线、边距和字体排版在每道接缝处出现割裂。Kling Image 4.0 Long Image 通过在单次请求中渲染从顶部首屏到页脚的一整张连续竖版 PNG 长图来解决这一问题。[1]
本教程将详细介绍 reAPI 上 webpage 与 ecommerce 两种模式的确切接口规范,包括参考图规则、@id 提及方式、1K 与 2K 分辨率规划、2026 年 11 月 20 日核对的当前 reAPI 按页价格,以及竖版 PNG 长图所需的轮询与文件检查步骤。[2]
快速概览
- 两种独立技能模式: 每次调用都必须指定
settings.skill。制作整页滚动落地页方案时选择webpage(0 至 2 张可选参考图,省略settings.length);制作商品详情页时选择ecommerce(需要 1 至 3 张refer_image照片,并配合short、medium或long长度)。[1] - 每个任务输出一张长图 PNG: 输出宽度固定为 1K(1024 px)或 2K(2048 px),竖向高度会根据简报中的版块自适应。不支持
4k。[2] - 参考图角色不可混用:
refer_image仅适用于ecommerce模式;style_refer_image和subject_refer_image仅适用于webpage模式。不支持 element 参考。[2] - 按页计费: 根据 2026 年 11 月 20 日核对的数据,reAPI 费率从 US$0.2269(
ecommerce、short、1k)到 US$0.8319(ecommerce、long、2k)不等,其中webpage为 US$0.5294(1k)或 US$0.5748(2k),另外从第一张起每张输入参考图收取 US$0.003025。参见实时价格表。[3] - 为较长渲染时间与大文件做好规划: 多版块渲染通常需要数分钟,2K 竖版 PNG 长图可能超过 50 MB。请相应设置 HTTP 下载超时时间与图像查看工具。[2]
先从一份 1K 网页简报开始
在上传多张商品照片或为 2K 长布局付费之前,先向 Kling Image 4.0 Long Image 发送一条仅包含文本的 1K 宽度 webpage 请求。1K 网页任务可以让你在不额外耗费高分辨率渲染时间或参考图配置精力的情况下,验证竖向版块节奏、色彩对比度与视觉层级。
在单个 prompt 项中按从上到下的确切顺序列出每个版块。明确写出首屏横幅、中间卖点分区、网格或对比条带以及结尾页脚区块。像“制作一个现代咖啡网站”这样模糊的请求会让版块数量和视觉节奏全凭运气,而带编号的竖向大纲能为你审核输出时提供具体的核对清单。
curl https://reapi.ai/api/v1/images/generations \
-H 'Authorization: Bearer YOUR_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. Section 1: full-bleed hero banner with warm morning light over a pour-over bar and headline space on the left. Section 2: three single-origin bean cards with origin notes and roast level tags. Section 3: brewing guide strip showing grind size, water temperature, and pour timing. Section 4: minimal footer with cafe address and opening hours."
}
],
"settings": {
"skill": "webpage",
"resolution": "1k"
}
}'该端点会返回一个包含任务 id 和 status: "processing" 的 JSON 对象。请立即保存该 ID。与十秒即可完成的单图端点不同,连续多版块布局需要更长的渲染时间。请使用同一个 Bearer 密钥轮询 GET /api/v1/tasks/{id},直到 status 切换为 completed 或 failed。[4]
在 Kling Image 4.0 Long Image 中选择电商或网页模式
发送至 Kling Image 4.0 Long Image 的每次请求都必须包含 settings.skill。选择正确的模式至关重要,因为每种技能都会强制执行各自的参考图类型与长度控制,混用会在计费前触发校验错误。[2]
| 规则 | ecommerce 模式 | webpage 模式 |
|---|---|---|
| 目标输出 | 多版块商品详情页 | 整页滚动网页视觉布局 |
| 允许的参考图类型 | 仅限 refer_image | 仅限 style_refer_image 与 subject_refer_image |
| 参考图数量 | 必须 1 至 3 张 | 0 至 1 张风格参考图与 0 至 1 张主体参考图(均可选) |
settings.length | short、medium(默认)或 long | 忽略(请求中请省略) |
settings.resolution | 1k(默认)或 2k | 1k(默认)或 2k |
options.watermark_info.enabled | 仅限 false | 仅限 false |
只要你已经准备好真实商品摄影图,并需要为网店制作连贯的竖版商品详情页,就使用 Kling Image 4.0 Long Image 的 ecommerce 模式。三种长度档位对应创作者文档中说明的大致版块数量:short 约 2 至 5 个版块,medium 约 6 至 10 个版块,long 约 11 至 18 个版块。[1]
当你需要制作品牌落地页、发布页或专题微站原型时,请使用 Kling Image 4.0 Long Image 的 webpage 模式;该模式下你可以从纯文案起步,也可以将一张视觉风格参考图与一张主视觉主体照片结合使用。由于 webpage 模式是根据你的版块列表而非 length 枚举值来决定竖向深度,省略 settings.length 可以让请求保持简洁并与接口结构一致。
正确配置命名参考图以避免校验报错
参考图是在 Kling Image 4.0 Long Image 整页滚动设计中保持真实商品可辨识度的主要手段。contents 中的每一项参考图都需要包含 type、可公开访问的 HTTP 或 HTTPS url,以及一个可选的唯一 id。reAPI 网关会拒绝 Base64 字符串和 data: URI。[2]
提交前,每个参考图文件必须满足四项格式检查:
- 格式: 仅支持 JPEG 或 PNG。
- 文件大小: 每张图片不超过 30 MB。
- 最小尺寸: 宽度和高度均至少为 300 像素。
- 宽高比: 介于 2:5 至 5:2 之间。
调用端点前,请在未登录的浏览器窗口中检查每个参考图链接。依赖过期控制台 Cookie 的素材 URL 在渲染工作节点抓取时会失败。
电商商品详情页示例
在 Kling Image 4.0 Long Image 的 ecommerce 模式下,提供一至三项 refer_image,并为每个角度指定清晰简短的 id(例如 front 和 spout)。在提示词中直接以 @front 和 @spout 引用这些名称,以便布局模型明确哪张照片用于固定首屏横幅、哪张照片用于驱动微距细节标注分区。
{
"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 a medium ecommerce product detail page for the brushed-steel gooseneck kettle in @front. Section 1: full-bleed hero showing @front on warm travertine stone with clean headline space. Section 2: three core benefit callouts covering pour precision, balanced handle ergonomics, and stainless body durability. Section 3: close-up detail band highlighting the curved spout from @spout with flow-control annotations. Section 4: morning pour-over brewing lifestyle scene. Section 5: care instructions and verified specification list."
}
],
"settings": {
"skill": "ecommerce",
"length": "medium",
"resolution": "2k"
}
}网页风格与主体参考图示例
在 Kling Image 4.0 Long Image 的 webpage 模式下,将审美方向与产品本身分离开来。最多附加一张 style_refer_image 来引导配色方案、网格节奏与排版风格,并最多附加一张 subject_refer_image 来保持实物外观准确。同一次请求中的每个 id 都必须唯一。
{
"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 tall watch launch webpage that matches the pale sandstone palette and editorial grid rhythm of @layout while showcasing @watch. Section 1: hero header featuring @watch at center-right. Section 2: three-column craft overview covering case finish, crystal clarity, and strap taper. Section 3: close-up dial and lug detail strip. Section 4: full technical specifications grid and clean minimal footer."
}
],
"settings": {
"skill": "webpage",
"resolution": "2k"
}
}撰写长简报时请注意加权提示词长度限制。Kling Image 4.0 Long Image 最多接受 166,000 个英文字符或 71,000 个非英文字符,混排文本受 english / 166000 + non_english / 71000 <= 1 约束。在将 @id 名称映射为位置标记后系统还会再次校验该上限,因此如果你的提示词接近上限,请保留少量安全余量。[2]
跨 1K、2K 与长度档位规划预算
与按单张输出图块计费的标准静态图生成器不同,Kling Image 4.0 Long Image 对每次已完成的请求按一笔输出档位费率加上每张输入参考图(包含第一张参考图)的费用计价。未交付任何输出的失败生成任务会自动退还预留的 credit。[2]
下表列出了 2026 年 11 月 20 日核对的 reAPI 当前费率(1 credit = $0.001 USD,$1 = 1,000 credits)。在运行大批量任务前,请务必在 Kling Image 4.0 Long Image 价格页面确认最新生效费率。[3]
| 档位 | 分辨率 | reAPI 费率(2026 年 11 月 20 日核对) | 典型用途 |
|---|---|---|---|
ecommerce · short | 1k / 2k | US$0.2269 / US$0.2723 | 紧凑型 2–5 版块商品概览页 |
ecommerce · medium | 1k / 2k | US$0.4538 / US$0.5294 | 标准 6–10 版块店铺详情页 |
ecommerce · long | 1k / 2k | US$0.7563 / US$0.8319 | 完整 11–18 版块旗舰商品长页 |
webpage | 1k / 2k | US$0.5294 / US$0.5748 | 整页滚动落地页或营销活动布局 |
| 输入参考图 | 任意 | 每张 US$0.003025 | 对提供的每张参考照片计费一次 |
以 2026 年 11 月 20 日的费率举例计算:包含两张商品照片的 ecommerce medium 2k 请求总费用为 $0.5294 + 2 × $0.003025 = $0.53545。提交时,reAPI 会预留 ceil(0.53545 × 1000) = 536 个整数 credit,任务完成后按精确微美元结算,并将零头差额退回你的余额。[2]
控制 Kling Image 4.0 Long Image 开销的一个实用方法是采用两阶段工作流:先在 1k(或优先验证商品还原度时使用 ecommerce short 1k)下草拟布局顺序和版块文案,逐个分区检查无误后,仅在视觉序列定稿时再升级到 2k。
可靠轮询并检查竖版 PNG 长图输出
提交 Kling Image 4.0 Long Image 请求后,按固定间隔(例如每 5 至 10 秒)轮询 GET /api/v1/tasks/{id};对于 long + 2k 任务,客户端超时预算应至少设为 15 至 20 分钟。轮询请求短暂波动时切勿自动重试 POST /v1/images/generations,因为每次新的 POST 都会创建一个新的可计费任务。[4]
当 status 变为 completed 时,从 output.image_urls[0] 读取唯一链接并立即将 PNG 转存到你自己的存储中。由于 2K 长布局文件可能超过 50 MB 且垂直高度超过 15,000 像素,请将文件流式下载至磁盘,避免在小型无服务器函数内存中缓冲完整文件,并分两步检查结果:
- 整页缩略图扫视: 缩小视图,检查视觉节奏、从头到尾的色彩一致性,以及各版块之间是否界限清晰。
- 100% 逐版块局部审阅: 按原生像素比例检查首屏标题、商品轮廓、材质质感、卖点标注标签以及底部规格参数区。
简报中仅应包含经过核实的产品尺寸、保修条款和技术规格。在 100% 缩放下核对文案准确性,可以在布局进入店铺切图或前端开发之前及时发现变形数字或漏字问题。
常见问题
可以使用 Kling Image 4.0 Long Image 生成 4K 竖版页面吗?
不可以。Kling Image 4.0 Long Image 仅支持 1k(宽 1024 px)和 2k(宽 2048 px)输出。指定 4k 的请求会在预留 credit 前因校验错误被拒绝。如需生成 4K 单张静态图或多镜头组图,请使用 Kling Image 4.0。
为什么不传参考图的电商请求会校验失败?
电商模式要求在 contents 中提供 1 至 3 项 refer_image,以便模型围绕真实商品照片构建每一个竖向版块。如果你想仅凭文本生成竖版布局,请将 settings.skill 设为 webpage。
可以在同一次请求中同时使用 refer_image 和 style_refer_image 吗?
不可以。参考图角色按模式严格隔离:ecommerce 仅接受 refer_image,而 webpage 仅接受 style_refer_image 和 subject_refer_image。Playground 会在提交前拦截混用;若通过 API 直接提交,请求可能先预扣 credit 并在异步处理阶段失败,系统会自动退还预扣额度。
第一张参考图会计入费用吗?
会。在已完成的任务中,contents 里提供的每张输入参考图都会计费一次,从第一张图片起算。未生成输出的失败任务会自动退还预留的 credit。
Kling Image 4.0 Long Image 与 Kling Image 4.0 有何不同?
Kling Image 4.0 Long Image 输出一张针对竖向电商详情页和网页布局优化的连续竖版 PNG 长图。Kling Image 4.0 则以 2K 或 4K 输出标准宽高比静态图(最多 9 张独立候选图或 2–10 张组图)。
应如何处理 50 MB 竖版 PNG 长图的下载?
将 HTTP 下载超时时间设为 60 秒以上,把响应字节直接流式写入对象存储或磁盘,并在下载后先校验 Content-Length 或 PNG 尺寸,再运行切图脚本。
将 Kling Image 4.0 Long Image 投入生产
先在 Kling Image 4.0 Long Image 试用台中测试一条 1k 网页提示词,以验证版块节奏和视觉平衡。当竖向大纲符合你的店铺或营销活动结构后,锁定参考图 URL,按照 Kling Image 4.0 Long Image API 文档中的请求结构,围绕 output.image_urls[0] 搭建可复用的轮询与切图流水线。
参考资料
- Kling AI, Kling Image 4.0 Long Image Generation API — 官方
ecommerce与webpage技能规范、长度档位指南及参考图限制。 - reAPI, Kling Image 4.0 Long Image API documentation — 请求结构、HTTP(S) 参考图约束、加权提示词上限、输出结构及计费机制。
- reAPI, Kling Image 4.0 Long Image model page and live pricing — 2026 年 11 月 20 日核对的各档位输出与每张参考图实时费率。
- reAPI, Tasks API reference — 异步任务轮询、终态及错误处理。