跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
使用 kling-4.0-long-image 把完整的网站页面或电商商品详情页设计成一张长图,从首屏一直到页脚。适合落地页样稿、网站改版方案和网店商品详情页。Kling Image 4.0 Long Image 属于快手 Kling Image 4.0 系列。

模型

  • kling-4.0-long-image — 网页和电商商品详情页的长图设计

功能

  • 网页设计:在一张长图中呈现完整的网站版式,例如首屏、产品展示、品牌故事和页脚等区块。
  • 电商商品详情页:围绕 1 到 3 张商品图设计,页面长度可选 short、medium 或 long。
  • 网页设计支持风格参考图(@StyleImage)和主体参考图(@SubjectImage)。
  • 输出 1K(1024 像素宽)或 2K(2048 像素宽),高度随内容变化。
  • 输出 PNG。

输入模式

  • 网页(skill:webpage,默认)— 在 prompt 中描述网站及其各个区块。可选传入 style_image_url,让设计沿用它的视觉与版式风格(@StyleImage);传入 subject_image_url,让设计围绕图中的主体展开(@SubjectImage)。
  • 电商(skill:ecommerce)— 在 image_urls 中传入 1 到 3 张商品图(@Image1、@Image2、@Image3),并在 prompt 中描述详情页。用 length 选择页面长度。

必填参数

  • prompt (string):描述页面及其各个区块的提示词,1–50,000 个字符,必须包含非空白文本。用 @Image1、@Image2、@Image3 指代商品图,用 @StyleImage 指代风格参考图,用 @SubjectImage 指代主体参考图。

可选参数

  • skill (string):webpage 或 ecommerce。默认为 webpage。
  • image_urls (array of strings):ecommerce 的商品图,1 到 3 个可公开访问的 HTTP(S) 图片 URL,该模式下必填。每张图片不超过 30 MB,宽和高至少 300 像素,宽高比(宽 / 高)在 0.4 到 2.5 之间。
  • style_image_url (string):webpage 的风格参考图 URL。设计会沿用它的视觉与版式风格。
  • subject_image_url (string):webpage 的主体参考图 URL。设计会围绕图中的主体展开。
  • length (string):ecommerce 的页面长度:short(约 2–5 个区块)、medium(约 6–10 个区块)或 long(约 11–18 个区块)。默认为 medium。
  • resolution (string):1K 或 2K。默认为 1K。

输出

  • 在 files 中返回一张 PNG 长图。1K 时宽 1024 像素,2K 时宽 2048 像素;高度取决于内容和页面长度。
  • 示例:1K 的 webpage 设计约为 1024×5848;2K 的 ecommerce long 页面可达 2048×54941(约 87 MB)。

示例

网页

参照参考图风格设计的咖啡品牌网站:

电商详情页

根据一张商品图生成的中等长度商品详情页:

注意事项

  • image_urls 和 length 用于 skill 为 ecommerce 的请求;style_image_url 和 subject_image_url 用于 skill 为 webpage 的请求。
  • 即使只有一张图,image_urls 也必须是数组。
  • 每次请求生成一张图片。
  • 长图通常需要约 2 到 12 分钟:网页设计和 1K 电商页面约 2 到 4 分钟,2K 的 long 电商页面最长约 12 分钟。请使用 callback_url 或轮询查询任务状态直到任务完成。
  • 如需生成普通图片、编辑图片或生成组图,请使用 Kling Image 4.0。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

请求体

application/json
model
enum<string>
必填

Kling Image 4.0 Long Image 模型标识。

可用选项:
kling-4.0-long-image
input
object
必填

生成一张长图:网页设计(skill 为 webpage),或根据 1–3 张商品图设计的电商商品详情页(skill 为 ecommerce)。

callback_url
string<uri>

可选的 Webhook URL,用于任务完成或失败时的通知。

响应

任务提交成功

code
enum<integer>
必填

业务状态码。200 表示成功,其他值都表示请求失败。请务必检查这个字段:部分参数校验错误会以 HTTP 200 返回,响应体里的 code 为 400。

  • 200:成功
  • 400:请求参数无效
  • 401:API Key 缺失或无效
  • 402:积分不足
  • 403:没有权限
  • 404:资源不存在
  • 408:请求超时
  • 429:请求频率超限
  • 500:服务器内部错误
  • 502:上游服务错误
  • 503:服务暂不可用

详见错误码。

可用选项:
200,
400,
401,
402,
403,
404,
408,
429,
500,
502,
503
示例:

200

data
object
必填