跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
Kling Image 4.0 图像编辑根据文字指令修改或组合参考图。按顺序用 @Image1、@Image2 引用图片,并可加入主体(从多个角度展示的角色或物体)来保持主体一致,最高输出 8K 或连贯组图。 只用提示词生成图片时,请使用 Kling Image 4.0 文生图。

模型

  • kwaivgi/kling-image-v4.0/edit — Kling Image 4.0 图像编辑,1–10 张参考图,最多 7 个主体。

功能

  • 编辑一张图片或组合最多 10 张参考图,在提示词中用 @Image1、@Image2… 引用。
  • 主体(kling_elements):最多 7 个角色或物体,每个 2–4 个角度,用 @Element1、@Element2… 引用。
  • 原生 2K、4K、8K 输出;最多 9 张图片或 2–10 张连贯组图。

必填参数

  • prompt (string):编辑指令。1–50,000 个字符的文本。用 @Image1、@Image2 引用参考图,用 @Element1、@Element2 引用主体。
  • image_urls (string[]):1–10 张参考图。第一个 URL 是 @Image1,第二个是 @Image2,依此类推。每张图片须是公开可访问的 HTTP(S) URL,最大 30 MB,宽和高都至少 300 像素,宽高比(宽 / 高)在 0.4 到 2.5 之间。

可选参数

  • kling_elements (object[]):最多 7 个主体。每个主体为 {"element_input_urls": [...]},包含同一角色或物体的 2–4 张图:第一张为正面,之后是 1–3 个其他角度。图片限制与 image_urls 相同。image_urls 张数加主体个数最多 10。
  • size (string):auto、16:9、9:16、1:1、4:3、3:4、3:2、2:3 或 21:9。默认 auto,根据提示词和参考图自动选择宽高比。
  • resolution (string):2K、4K 或 8K。默认 2K。
  • enable_sequential (boolean):为 true 时生成 n 张主体和风格一致的连贯组图。默认 false。
  • n (integer):图片数量。enable_sequential 为 false 时为 1–9(默认 1),为 true 时为 2–10(默认 4)。

分辨率

输出图片为 PNG 文件。8K 单张可能超过 100 MB,4K 约 25–30 MB,下载需要预留更长时间。

示例

  • 参考图加主体:把三个角度的角色放进客厅照片,2K。
  • 组合图片:把 @Image2 中的物体放进 @Image1。
  • 基于参考图的组图:同一房间的四个时段,enable_sequential: true,4K。

注意事项

  • 缺少 image_urls、超过 10 张图片、超过 7 个主体、某个主体少于 2 张或多于 4 张图,或图片与主体合计超过 10 个,都会返回 400。
  • 不满足尺寸限制(30 MB、300 像素、宽高比 0.4–2.5)的参考图会导致任务失败,失败任务会退还积分。
  • enable_sequential: true 时由模型决定组图的最终构成,偶尔返回的图片少于 n 张。
  • model 和 callback_url 放在请求根级,与 input 并列。input 接收上文列出的字段,其他字段返回 400。
  • 积分取决于 resolution 和图片数量(n),每张参考图和每个主体另有加价,每个任务只收一次。组图实际返回的图片少于 n 时,任务完成后退还缺少图片的积分。任务失败会全额退还。当前费率见定价页。

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"kwaivgi/kling-image-v4.0/edit"

input
object
必填
callback_url
string<uri>

可选的 Webhook URL,用于接收完成或失败通知。

示例:

"https://your-domain.com/callback"

响应

任务提交结果。任务 ID 标识一项异步任务;生成可能仍在进行中。

code
integer
必填
示例:

200

data
object
必填