跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
Kling Image 4.0 长图把整页设计成一张长图:网站页面(skill: webpage),或基于 1–3 张商品图的电商详情页(skill: ecommerce)。宽度由 resolution 决定,高度随内容变化,一次请求即可得到包含全部版块的完整页面效果图。 生成普通图片请使用 Kling Image 4.0 文生图 或 Kling Image 4.0 图像编辑。

模型

  • kwaivgi/kling-image-v4.0/long-image — 每次生成一张网页或电商详情页长图,宽 1K 或 2K。

功能

  • 网页设计,可选风格参考图(@StyleImage)和主体参考图(@SubjectImage)。
  • 基于 1–3 张商品图的电商详情页,三种长度(short、medium、long)。
  • 1K(宽 1024 像素)或 2K(宽 2048 像素)输出,高度随内容变化。

输入模式

必填参数

  • prompt (string):页面及各版块的描述。1–50,000 个字符的文本。用 @Image1–@Image3 引用商品图,用 @StyleImage 引用风格参考图,用 @SubjectImage 引用主体参考图。
  • image_urls (string[]):用于 skill: ecommerce,该模式下必填:1–3 张商品图,按顺序编号为 @Image1–@Image3。每张图片须是公开可访问的 HTTP(S) URL,最大 30 MB,宽和高都至少 300 像素,宽高比(宽 / 高)在 0.4 到 2.5 之间。

可选参数

  • skill (string):webpage 或 ecommerce。默认 webpage。
  • style_image_url (string):仅 skill: webpage。设计沿用这张图的视觉和版式风格(@StyleImage)。
  • subject_image_url (string):仅 skill: webpage。设计围绕这张图中的主体展开(@SubjectImage)。
  • length (string):仅 skill: ecommerce。short(约 2–5 个版块)、medium(约 6–10 个)或 long(约 11–18 个)。默认 medium。
  • resolution (string):1K(宽 1024 像素)或 2K(宽 2048 像素)。默认 1K。

输出

  • 每次请求返回一张 PNG 长图。1K 网页通常约 1024x5800 像素;2K 长版电商详情页高度可超过 50,000 像素、体积超过 80 MB。
  • 生成通常需要 1.5–4 分钟,2K 长版页面最长约 12 分钟。

示例

  • 网页:参照风格图设计的咖啡品牌官网,2K。
  • 电商详情页:基于一张商品图的 medium 长度详情页,1K。

注意事项

  • 每种 skill 使用各自的字段:skill: ecommerce 使用 1–3 张 image_urls 和 length,skill: webpage 使用 style_image_url 和 subject_image_url。传入另一种 skill 的字段会返回 400。
  • model 和 callback_url 放在请求根级,与 input 并列。input 接收上文列出的字段,其他字段返回 400。
  • 每次请求按固定积分计费,取决于 skill、length(ecommerce 时)和 resolution,每张参考图(商品图、风格图或主体图)另有加价。任务失败会全额退还。当前费率见定价页。

授权

Authorization
string
header
必填

使用 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

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

input
object
必填
callback_url
string<uri>

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

示例:

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

响应

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

code
integer
必填
示例:

200

data
object
必填