comparisons

Kling Image 4.0 API vs Kling O3 Image API:何时切换

Poyo.ai Team
5 min read
Share:

PoYo 上的 Kling Image 4.0 API vs Kling O3 Image API

在 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 或 WebPKling O3 Image(output_format)
4K 以上,或正好 8Kkling-4.0-image
一组 2–10 张主体和风格一致的图像kling-4.0-image 加 enable_sequential
超过 2,000 字符的提示词kling-4.0-image(最多 50,000)
把完整网页或电商详情页做成一张图kling-4.0-long-image
文生图和编辑使用同一个模型 IDkling-4.0-image

逐字段对比请求差异

两者都使用 POST https://api.poyo.ai/api/generate/submit、同一个状态接口和同一个 callback_url。差异在 model 和 input 中,以下内容取自两个模型各自的 PoYo 文档。

字段Kling O3 ImageKling Image 4.0 API
modelkling-o3-image(文生图)、kling-o3-image-edit(编辑)两者都用 kling-4.0-image;传 image_urls 即进入编辑模式
prompt最多 2,000 个字符1–50,000 个字符
image_urls1–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
resolution1K(默认)、2K、4K2K(默认)、4K、8K
size8 种比例,默认 16:9;auto 仅编辑模型支持同样 8 种比例外加 auto,默认 auto
output_formatjpeg、png(默认)、webp不接受;仅 PNG
n1–91–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 ImageKling Image 4.0 API
1 张,1K3.5 积分($0.0175)不提供(最低 2K:13 积分)
1 张,2K3.5 积分($0.0175)13 积分($0.065)
1 张,4K7 积分($0.035)19 积分($0.095)
1 张,8K不提供32 积分($0.16)
2K 编辑,2 张参考图 + 1 个元素3.5 积分($0.0175)16 积分($0.08)
4 张 2K14 积分($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"
   }
 }

检查清单:

  1. 把两个 O3 模型 ID 都换成 kling-4.0-image;是否为编辑模式现在由 image_urls 决定。
  2. 把 elements 改名为 kling_elements,并把 frontal_image_url 和 reference_image_urls 合并为一个 element_input_urls 数组,正面视图在前,共 2–4 个 URL。只有单一视角的 O3 元素至少需要再补一个视角。
  3. 删除 output_format。schema 会拒绝未知字段。
  4. 把 1K 改为 2K;如果你依赖 O3 的 16:9 默认值,请显式设置 size,因为新的默认值是 auto。
  5. 在费用估算中加上参考附加费。
  6. 对 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 以及其他所有模型。

Share: