跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
使用 kling-4.0-image 根据提示词制作照片、海报、产品图和分镜,也可以用同一个 model ID 传入参考图进行编辑与合成。Kling Image 4.0 是快手 Kling 4.0 系列的图像模型,最高可输出 8K。

模型

  • kling-4.0-image — 不传 image_urls 时为文生图;传入 1 到 10 张参考图的 image_urls 时为图生图

功能

  • 根据最多 50,000 个字符的提示词生成图像。
  • 支持图生图编辑和多参考图合成,最多 10 张参考图,在提示词中用 @Image1、@Image2 等依次指代。
  • 元素:最多 7 个人物或物体,每个用 2 到 4 个角度的图片描述,在提示词中用 @Element1、@Element2 等指代,用于保持主体一致。
  • 组图:一次请求生成 2 到 10 张主体与风格一致、画面连贯的图片,按顺序返回。
  • 每次请求最多生成 9 张相互独立的图片。
  • 支持 2K、4K 或 8K 输出,提供 8 种宽高比,也可以用 auto 由模型选择。
  • 输出 PNG。

输入模式

  • 文生图 — 不传 image_urls。在 prompt 中描述整幅画面。
  • 图生图 — 在 image_urls 中传入 1 到 10 个 URL。第一个 URL 是 @Image1,第二个是 @Image2,依此类推。该模式下还可以在 kling_elements 中传入最多 7 个元素,第一个元素是 @Element1。在提示词中用这些标记说明要保留、修改或合成的内容。image_urls 与 kling_elements 合计最多 10 项。

必填参数

  • prompt (string):描述图像或所需编辑的提示词,1–50,000 个字符,必须包含非空白文本。图生图时用 @Image1、@Image2 … 指代参考图,用 @Element1、@Element2 … 指代元素。

可选参数

  • image_urls (array of strings):1 到 10 个可公开访问的 HTTP(S) 参考图 URL。传入后进入图生图模式。每张图片不超过 30 MB,宽和高至少 300 像素,宽高比(宽 / 高)在 0.4 到 2.5 之间。
  • kling_elements (array of objects):图生图模式下的元素,与 image_urls 一起使用,最多 7 个。每个元素为 {"element_input_urls": [...]},包含同一人物或物体的 2 到 4 张图片 URL:第一张为正面图,其后为 1 到 3 张其他角度的图片。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):默认为 false,生成 n 张相互独立的图片。为 true 时生成 n 张画面连贯的组图,按顺序返回。
  • n (integer):图片数量。enable_sequential 为 false 时为 1–9,默认 1;enable_sequential 为 true 时为 2–10,默认 4。

分辨率

输出

  • 图片以 PNG 格式在 files 中返回。组图按顺序返回。

示例

文生图

一张 4K、16:9 的时尚大片:

带元素的图生图

把用三个角度描述的人物放进参考图中的房间:

组图

讲述同一个故事的四张连贯画面:

注意事项

  • 即使只有一张图,image_urls 也必须是数组。
  • 使用 kling_elements 时,需同时在 image_urls 中传入至少一张图片。
  • 参考图和元素按在 image_urls、kling_elements 中的顺序编号。为获得更好的效果,请在提示词中写明每一项的作用。
  • 从提交到 finished 的常见耗时:单张 2K 约 45 秒,单张 4K 1 分钟出头,单张 8K 约 2.5 分钟。图生图约 1 到 2.5 分钟,3 张 2K 组图约 3.5 分钟,9 张 8K 图片约 10 分钟,10 张 8K 组图约 30 分钟。请求较大时,请使用 callback_url 或轮询查询任务状态直到任务完成。
  • 如需设计完整的网页或电商详情页长图,请使用 Kling Image 4.0 Long Image。

授权

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 模型标识。不传 image_urls 为文生图;传入 1–10 张 image_urls 为图生图。

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

根据提示词生成图像。传入 image_urls 时编辑或合成参考图。

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
必填