
Kling Image 4.0 API 让开发者通过一个 PoYo 接口调用 Kling AI 最新的图像模型:用 kling-4.0-image 做文生图、图像编辑和组图,支持 2K、4K 或 8K;用 kling-4.0-long-image 生成完整的网页或电商页面设计。本文介绍 Kling Image 4.0 是什么、每个请求字段的作用、各项限制,以及在 PoYo 上调用一次的费用。
Kling Image 4.0 是什么?
Kling Image 4.0 是快手旗下 AI 创作平台 Kling AI 推出的 Kling 4.0 系列中的图像模型,于 2026 年 11 月 17 日发布。Kling 在发布文章中表示,该模型:
- 以原生 8K 生成图像,这是 Kling 首次在该模型中推出这一能力;
- 可用一条提示词生成最多 10 张图像,风格和内容保持一致;
- 单张图像中可渲染最多 2,000 个字符的文字,支持英语、简体中文、繁体中文、日语、韩语、西班牙语和葡萄牙语;
- 可生成用于电商商品详情页和网页设计的长图。
Kling 还表示,该模型已在 Kling 创作平台上线,并通过 API 向企业和开发者开放。PoYo 于 2026 年 11 月接入 Kling Image 4.0 API,无需排队等候,使用与调用 PoYo 其他所有模型相同的 API 密钥。
PoYo 上的 Kling Image 4.0 API 模型 ID
| 模型 ID | 用途 | 输出 |
|---|---|---|
kling-4.0-image | 文生图(不传 image_urls)、使用 1–10 张参考图的图生图、元素(elements)、组图 | 1–9 张独立图像,或 2–10 张一组,2K / 4K / 8K |
kling-4.0-long-image | skill: "webpage" 页面设计,skill: "ecommerce" 基于 1–3 张商品图的商品详情页 | 一张长图,宽 1024 px(1K)或 2048 px(2K) |
两个 ID 使用同一个提交接口、同一套任务轮询和同一个 callback_url webhook。落地页 slug 是 kling-4-0-image;请求中的模型 ID 使用点号(kling-4.0-image)。
接口与请求结构
每个 Kling Image 4.0 API 请求都是异步任务:
- 向
POST https://api.poyo.ai/api/generate/submit发送请求,带上Authorization: Bearer $POYO_API_KEY,JSON 请求体包含model和input。 - 从响应中读取
data.task_id。 - 轮询
GET https://api.poyo.ai/api/generate/status/{task_id},直到status为finished或failed;也可以在顶层传入callback_url,任务结束时接收一个 POST 回调。
一个最简的 4K 请求,结构照搬文档:
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
任务完成后,图像位于 data.files 中,每项包含 file_url 和 file_type: "image"。组图按顺序返回。除了 HTTP 状态码,还要检查响应体中的 code 字段:PoYo 可能在 HTTP 200 的响应中返回 code: 400 表示校验错误。包含 cURL 和 Python 的分步说明见 Kling Image 4.0 API 指南。
输入字段与限制
kling-4.0-image
| 字段 | 取值 | 说明 |
|---|---|---|
prompt | 1–50,000 个字符 | 必填。用 @Image1、@Element1 引用输入 |
image_urls | 1–10 个 URL | 传入即为图生图。每张图片最大 30 MB,每边至少 300 px,宽高比 0.4–2.5 |
kling_elements | 最多 7 个元素 | 每个为 {"element_input_urls": [...]},含 2–4 个视角,正面在前。需要同时传 image_urls。图片加元素 ≤ 10 |
size | auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3、21:9 | 默认 auto |
resolution | 2K、4K、8K | 默认 2K。8K 在 1:1 下为 8192×8192 |
enable_sequential | true / false | true 返回一组连贯的组图 |
n | 1–9(独立图像)或 2–10(组图) | 默认分别为 1 和 4 |
schema 会拒绝未知字段,因此不要传 output_format、seed 或 negative_prompt。输出为 PNG。
kling-4.0-long-image
| 字段 | 取值 | 说明 |
|---|---|---|
skill | webpage(默认)、ecommerce | 选择页面类型 |
image_urls | 1–3 张商品图 | ecommerce 必填 |
style_image_url / subject_image_url | 各一个 URL | 仅 webpage;对应 @StyleImage、@SubjectImage |
length | short、medium(默认)、long | 仅 ecommerce:约 2–5、6–10 或 11–18 个版块 |
resolution | 1K(默认)、2K | 宽 1024 或 2048 px;高度随内容而定 |
每个长图请求返回一张图像。
PoYo 上的 Kling Image 4.0 API 价格
PoYo 按生成的图像计费(1 积分 = $0.005)。只有任务成功才扣积分。
| 请求 | 积分 | 美元 |
|---|---|---|
kling-4.0-image,2K,每张 | 13 | $0.065 |
kling-4.0-image,4K,每张 | 19 | $0.095 |
kling-4.0-image,8K,每张 | 32 | $0.16 |
每个 image_urls 项和每个 kling_elements 元素,每次请求计一次 | 1 | $0.005 |
| 长图,webpage,1K / 2K | 110 / 120 | $0.55 / $0.60 |
| 长图,ecommerce short,1K / 2K | 47 / 57 | $0.235 / $0.285 |
| 长图,ecommerce medium,1K / 2K | 94 / 110 | $0.47 / $0.55 |
| 长图,ecommerce long,1K / 2K | 157 / 173 | $0.785 / $0.865 |
长图,image_urls、style_image_url 或 subject_image_url 中的每张图片 | 1 | $0.005 |
长图价格表和计算示例见价格详解。
发布当天的实测
PoYo 团队于 2026 年 11 月 19 日在生产 API 上运行了以下请求。耗时是轮询客户端看到的从提交到出结果的时间,仅供参考。
| 请求 | 输出 | 费用 | 耗时 |
|---|---|---|---|
kling-4.0-image,文生图,16:9,8K,n: 1 | 10880×6144 PNG,约 128 MB | 32 积分 | 约 3.8 分钟 |
kling-4.0-image,16:9,2K,enable_sequential: true,n: 4 | 四张 2720×1536 图像,同一骑手、同一辆车和同一套服装,从黎明到夜晚 | 52 积分 | 约 4.9 分钟 |
kling-4.0-long-image,skill: "webpage",1K | 一张 1024×4257 页面 | 110 积分 | 约 1.7–2.2 分钟 |
同一轮测试中还有两点集成注意事项。下载到的 PNG 文件即使是不透明图像也带 alpha 通道(RGBA),如果你的流程需要 RGB 或 JPEG,请显式转换。另外,一条英文网页提示词没有指定页面文案的语言,结果返回了中文文字;加上 "All text on the page is in English." 后问题解决。两点的详细说明见 8K 与长图。
哪些请求该交给 Kling Image 4.0 API?
- 印刷、广告牌和大量裁切的工作,需要 4K 以上分辨率:它是 PoYo 上唯一提供
8K档位的图像模型。 - 分镜、商品多角度图和幻灯片,需要同一角色或商品在各帧中保持一致:使用
enable_sequential。 - 把已有商品或角色放进新场景:在
image_urls中传入场景,把主体作为多角度元素传入。 - 落地页样稿和电商详情页,以一张图输出:使用
kling-4.0-long-image。
如果要以最低价格快速出 1K–2K 草图,Kling O3 Image 的单张价格更低;见 Kling Image 4.0 API vs Kling O3 Image。与其他厂商的对比见 Kling Image 4.0 vs GPT Image 2.6 vs Seedream 5.5。
常见问题
Kling Image 4.0 API 是什么?
它是 PoYo 提供的 Kling AI Kling Image 4.0 模型的 REST 接入,模型 ID 为 kling-4.0-image(标准图像、编辑和组图)和 kling-4.0-long-image(网页和电商长图页面)。两者都使用 POST /api/generate/submit 和同一个 API 密钥。
Kling Image 4.0 API 多少钱? 2K 每张 13 积分($0.065),4K 每张 19 积分($0.095),8K 每张 32 积分($0.16),另外每张参考图或每个元素每次请求加收 1 积分($0.005)。长图每页 47 到 173 积分。失败的任务不扣费。
Kling Image 4.0 API 支持图生图吗?
支持。使用 kling-4.0-image 时在 image_urls 中传入 1 到 10 个 URL,并在提示词中用 @Image1、@Image2 引用。如需保持角色或物体一致,可再加最多 7 个 kling_elements;图片加元素上限为 10。
Kling Image 4.0 API 请求需要多长时间?
在我们发布当天的测试中,一张 16:9 8K 图像约 3.8 分钟,一组四张的 2K 组图约 4.9 分钟,一张 1K 网页约 2 分钟。大任务请使用 callback_url,不要长时间挂着请求等待。
Kling Image 4.0 API 文档在哪里? 字段说明见 Kling Image 4.0 文档和长图文档。模型页提供在线试用,并显示与你的设置对应的 JSON。