跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
Kling Image 4.0 文生图根据提示词生成高分辨率图片,支持 2K 到原生 8K。每次请求最多生成 9 张独立图片,或生成 2–10 张主体和风格一致的连贯组图,适合分镜、产品套图和分步骤示意图。 如需编辑或组合参考图,请使用 Kling Image 4.0 图像编辑。如需设计整页网页或电商详情页长图,请使用 Kling Image 4.0 长图。

模型

  • kwaivgi/kling-image-v4.0/text-to-image — Kling Image 4.0 文生图,每次 1–9 张图片或 2–10 张组图。

功能

  • 原生 2K、4K、8K 输出。
  • 每次请求最多 9 张独立图片。
  • 连贯组图(enable_sequential):2–10 张主体和风格一致的图片,按顺序返回。
  • 9 种宽高比,或用 auto 由模型选择。

必填参数

  • prompt (string):图片描述。1–50,000 个字符的文本。

可选参数

  • 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,下载需要预留更长时间。

示例

  • 一张 4K 图片:16:9、4K 的时尚大片。
  • 多张独立图片:用 n: 3 生成同一产品图的三个版本。
  • 连贯组图:enable_sequential: true、n: 4 生成四格水彩故事。

注意事项

  • n 取值 1–9(enable_sequential: true 时为 2–10),resolution 取值 2K、4K、8K,其他值返回 400。使用参考图请用 Kling Image 4.0 图像编辑。
  • 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/text-to-image"

input
object
必填
callback_url
string<uri>

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

示例:

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

响应

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

code
integer
必填
示例:

200

data
object
必填