curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1794470400-abcd1234",
"status": "not_started",
"created_time": "2026-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}Kling
Kling Image 4.0
Kling Image 4.0 API 可根据提示词生成图像,也可以编辑最多 10 张参考图。支持用元素保持主体一致、生成画面连贯的组图,以及 2K、4K 或 8K 输出。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.poyo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
'{
"code": 200,
"data": {
"task_id": "task-unified-1794470400-abcd1234",
"status": "not_started",
"created_time": "2026-11-12T10:30:00"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}{
"code": 400,
"error": {
"message": "Invalid request parameters",
"type": "invalid_request_error"
}
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
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。
分辨率
resolution | 输出示例 | PNG 文件大小(参考) |
|---|---|---|
2K | 1:1 时为 2048×2048 | 约 7.5 MB |
4K | 16:9 时为 5440×3072 | 约 27 MB |
8K | 1:1 时为 8192×8192 | 约 100 MB |
输出
- 图片以 PNG 格式在
files中返回。组图按顺序返回。
示例
文生图
一张 4K、16:9 的时尚大片:{
"model": "kling-4.0-image",
"input": {
"prompt": "High fashion model wearing a dress made of living moss, standing in an abandoned greenhouse, shafts of light, editorial photography",
"size": "16:9",
"resolution": "4K"
}
}
带元素的图生图
把用三个角度描述的人物放进参考图中的房间:{
"model": "kling-4.0-image",
"input": {
"prompt": "Place @Element1 sitting on the sofa in @Image1, reading a book in warm evening light. Keep the room layout of @Image1 unchanged.",
"image_urls": ["https://example.com/living-room.png"],
"kling_elements": [
{
"element_input_urls": [
"https://example.com/character-front.png",
"https://example.com/character-side.png",
"https://example.com/character-back.png"
]
}
],
"resolution": "2K"
}
}
组图
讲述同一个故事的四张连贯画面:{
"model": "kling-4.0-image",
"input": {
"prompt": "A four-panel story of a paper boat drifting from a rainy city gutter to a calm sunny lake, same boat in every panel, watercolor style",
"size": "3:2",
"enable_sequential": true,
"n": 4
}
}
注意事项
- 即使只有一张图,
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。
授权
所有 API 接口都需要 Bearer Token 认证。
创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。
在请求头中添加:
Authorization: Bearer YOUR_API_KEY
请求体
application/json
响应
任务提交成功
业务状态码。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