
在 PoYo 上,Kling Image 4.0 API(kling-4.0-image)是 Kling O3 Image API(kling-o3-image 和 kling-o3-image-edit)的后继者。简单来说:Kling Image 4.0 新增了 8K、组图、50,000 字符的提示词和一个独立的长页面模型,单张价格约为原来的三到四倍。本文逐个请求对比两者,帮你决定哪些调用值得迁移。两者都在 PoYo 上:Kling Image 4.0 和 Kling O3 Image。
一张表做决定
| 如果你的请求需要… | 调用 |
|---|---|
| 1K 输出,或最低的单张价格 | kling-o3-image / kling-o3-image-edit |
| 由 API 直接输出 JPEG 或 WebP | Kling O3 Image(output_format) |
| 4K 以上,或正好 8K | kling-4.0-image |
| 一组 2–10 张主体和风格一致的图像 | kling-4.0-image 加 enable_sequential |
| 超过 2,000 字符的提示词 | kling-4.0-image(最多 50,000) |
| 把完整网页或电商详情页做成一张图 | kling-4.0-long-image |
| 文生图和编辑使用同一个模型 ID | kling-4.0-image |
逐字段对比请求差异
两者都使用 POST https://api.poyo.ai/api/generate/submit、同一个状态接口和同一个 callback_url。差异在 model 和 input 中,以下内容取自两个模型各自的 PoYo 文档。
| 字段 | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
model | kling-o3-image(文生图)、kling-o3-image-edit(编辑) | 两者都用 kling-4.0-image;传 image_urls 即进入编辑模式 |
prompt | 最多 2,000 个字符 | 1–50,000 个字符 |
image_urls | 1–10,kling-o3-image-edit 必填 | 1–10(可选);每张 30 MB、≥300 px、宽高比 0.4–2.5 |
| 元素 | elements: [{frontal_image_url, reference_image_urls}] | kling_elements: [{element_input_urls: [front, …]}],2–4 个视角,最多 7 个,图片 + 元素 ≤ 10 |
resolution | 1K(默认)、2K、4K | 2K(默认)、4K、8K |
size | 8 种比例,默认 16:9;auto 仅编辑模型支持 | 同样 8 种比例外加 auto,默认 auto |
output_format | jpeg、png(默认)、webp | 不接受;仅 PNG |
n | 1–9 | 1–9 张独立图像,或 enable_sequential: true 时 2–10 张 |
enable_sequential | 不支持 | true 返回有序且一致的组图 |
| 长页面 | 不支持 | 独立模型 kling-4.0-long-image |
Kling 在发布文章中称 Kling Image 4.0 是其首个支持原生 8K 生成的模型,能用一条提示词规划最多 10 张图像,并以七种语言渲染最多 2,000 个字符的文字。这些是 Kling 的说法;上面的 API 差异才是你代码中需要改动的地方。
同一请求的价格
以下为 PoYo 价格,1 积分 = $0.005。在 PoYo 上 Kling O3 Image 没有参考附加费;Kling Image 4.0 API 每张参考图或每个元素加收 1 积分,每次请求计一次。Kling 自己的价格页也注明了这一变化:Kling Image 4.0 对参考输入收费,此前的模型不收费。
| 同一请求 | Kling O3 Image | Kling Image 4.0 API |
|---|---|---|
| 1 张,1K | 3.5 积分($0.0175) | 不提供(最低 2K:13 积分) |
| 1 张,2K | 3.5 积分($0.0175) | 13 积分($0.065) |
| 1 张,4K | 7 积分($0.035) | 19 积分($0.095) |
| 1 张,8K | 不提供 | 32 积分($0.16) |
| 2K 编辑,2 张参考图 + 1 个元素 | 3.5 积分($0.0175) | 16 积分($0.08) |
| 4 张 2K | 14 积分($0.07),独立图像 | 52 积分($0.26),组图或独立图像 |
| 网页设计,1K | 不提供 | 110 积分($0.55) |
2K 下 Kling Image 4.0 API 的单张价格约为 Kling O3 Image 的 3.7 倍,4K 下约为 2.7 倍。完整的 Kling Image 4.0 价格表见 Kling Image 4.0 API 价格。
有变化的限制
- 分辨率下限提高。 1K 没有了;Kling Image 4.0 的最小输出是 2K。如果你要提供缩略图,请继续用 O3,或在自己这边缩放。
- 上限提高到 8K。 PoYo 文档给出 1:1 下为 8192×8192。在我们发布当天的测试中(PoYo 生产 API,2026 年 11 月 19 日),一个 16:9 8K 请求返回了一张 10880×6144、约 128 MB 的 PNG,耗时约 3.8 分钟,费用 32 积分。
- 文件处理。 没有
output_format:输出为 PNG。我们下载到的即使是不透明图像也是 RGBA PNG。如果你在 O3 上用的是jpeg或webp,请规划好转换和存储。 - 参考图规则明确。 Kling Image 4.0 会校验每张参考图:最大 30 MB,每边至少 300 px,宽高比在 0.4 到 2.5 之间。O3 文档没有列出这些限制,因此迁移前请先校验特别宽或特别小的图片。
- 组图耗时更长。 我们的四张 2K 组图耗时约 4.9 分钟。耗时长或体积大的任务请改用
callback_url。
何时切换
当某个调用需要 O3 做不到的事情时,把它切换到 kling-4.0-image:8K、一致的组图、长提示词或页面设计。例如:
- 分镜和商品多角度图。 在 O3 上你只能发送
n: 4,然后指望主体一致。设置enable_sequential: true后,模型会把整组图作为一个整体规划;我们的测试中,骑手、车和服装在黎明、正午、日落和夜晚中保持一致。 - 印刷和需要大量裁切的素材。 任何高于 4K 的需求。
- 长且结构化的提示词。 超过 2,000 字符的品牌规范、镜头清单和文案块。
- 电商页面。
kling-4.0-long-image能生成整张详情页;O3 没有对应能力。
大批量的 1K–2K 草稿、缩略图,以及需要 API 直接输出 JPEG 或 WebP 的流程,继续用 O3。两者并用也完全可以:用 O3 探索,用 Kling Image 4.0 出最终组图,使用同一个密钥。
迁移 diff
文生图调用:
{
- "model": "kling-o3-image",
+ "model": "kling-4.0-image",
"input": {
"prompt": "A cinematic futuristic alley with rain and neon reflections",
"resolution": "4K",
"size": "16:9",
- "output_format": "png",
"n": 2
}
}
带元素的编辑调用。两个字段改名,两个模型 ID 合并为一个:
{
- "model": "kling-o3-image-edit",
+ "model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
- "elements": [
- {
- "frontal_image_url": "https://example.com/character-front.png",
- "reference_image_urls": ["https://example.com/character-side.png"]
- }
- ],
+ "kling_elements": [
+ {
+ "element_input_urls": [
+ "https://example.com/character-front.png",
+ "https://example.com/character-side.png"
+ ]
+ }
+ ],
- "resolution": "1K",
- "size": "auto",
- "output_format": "png"
+ "resolution": "2K",
+ "size": "auto"
}
}
检查清单:
- 把两个 O3 模型 ID 都换成
kling-4.0-image;是否为编辑模式现在由image_urls决定。 - 把
elements改名为kling_elements,并把frontal_image_url和reference_image_urls合并为一个element_input_urls数组,正面视图在前,共 2–4 个 URL。只有单一视角的 O3 元素至少需要再补一个视角。 - 删除
output_format。schema 会拒绝未知字段。 - 把
1K改为2K;如果你依赖 O3 的16:9默认值,请显式设置size,因为新的默认值是auto。 - 在费用估算中加上参考附加费。
- 对 8K 和组图任务调大客户端超时,或改用 webhook。
状态轮询、files[].file_url 解析和 webhook 验签都保持不变。完整的请求说明见 Kling Image 4.0 API 指南。
Kling O1 Image 呢?
Kling O1 Image 只支持编辑(kling-o1-image-edit),分辨率为 1K 或 2K,每张 3.5 积分。在上表中可以把它当作 kling-o3-image-edit:便宜的参考图编辑,没有 4K 或 8K,没有组图。
常见问题
Kling Image 4.0 API 能直接替换 Kling O3 Image API 吗?
基本可以。接口、鉴权、轮询和 webhook 都相同。你需要更改模型 ID、把 elements 改名为 kling_elements、删除 output_format,并把 1K 请求改为 2K。
Kling Image 4.0 API 和 Kling O3 Image 哪个更便宜? Kling O3 Image:1K 或 2K 每张 3.5 积分,4K 每张 7 积分;Kling Image 4.0 在 2K、4K 和 8K 下分别为 13、19 和 32 积分,并且每个参考加收 1 积分。
Kling O3 Image 支持 8K 或组图吗?
不支持。PoYo 上的 Kling O3 Image 最高 4K,返回 1–9 张独立图像。8K 和 enable_sequential 组图是 Kling Image 4.0 API 的功能。
Kling Image 4.0 API 还能输出 JPEG 吗? API 不能直接输出:结果为 PNG。请在下载后转换,或把 JPEG 和 WebP 任务留在 Kling O3 Image 上。
使用 Kling Image 4.0 API 需要新的 API 密钥吗?
不需要。同一个 PoYo 密钥可用于 kling-4.0-image、kling-4.0-long-image、kling-o3-image 以及其他所有模型。