curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-image-v4.0/edit",
"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://cdn.vidgo.ai/temp/reference-living-room.png"
],
"resolution": "2K",
"kling_elements": [
{
"element_input_urls": [
"https://cdn.vidgo.ai/temp/character-front.png",
"https://cdn.vidgo.ai/temp/character-side.png",
"https://cdn.vidgo.ai/temp/character-back.png"
]
}
]
}
}
'
{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "not_started",
"created_time": "2026-11-19T10:30:00"
}
}{
"detail": "prompt is required"
}{
"detail": "prompt is required"
}Kling
Kling Image 4.0 图像编辑
Kling Image 4.0 图像编辑 API 基于 1–10 张参考图和最多 7 个多角度主体进行编辑或组合,输出 2K、4K、8K 图片或连贯组图。
POST
/
api
/
generate
/
submit
curl --request POST \
--url https://api.vidgo.ai/api/generate/submit \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "kwaivgi/kling-image-v4.0/edit",
"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://cdn.vidgo.ai/temp/reference-living-room.png"
],
"resolution": "2K",
"kling_elements": [
{
"element_input_urls": [
"https://cdn.vidgo.ai/temp/character-front.png",
"https://cdn.vidgo.ai/temp/character-side.png",
"https://cdn.vidgo.ai/temp/character-back.png"
]
}
]
}
}
'
{
"code": 200,
"data": {
"task_id": "task-example-001",
"status": "not_started",
"created_time": "2026-11-19T10:30:00"
}
}{
"detail": "prompt is required"
}{
"detail": "prompt is required"
}- 提交后会返回
task_id。如果提供了callback_url,当任务状态变为finished或failed时,系统会向callback_url发送 POST 请求。 - 无论是否提供
callback_url,都可以通过统一的查询任务状态接口获取结果。
@Image1、@Image2 引用图片,并可加入主体(从多个角度展示的角色或物体)来保持主体一致,最高输出 8K 或连贯组图。
只用提示词生成图片时,请使用 Kling Image 4.0 文生图。
模型
- kwaivgi/kling-image-v4.0/edit — Kling Image 4.0 图像编辑,1–10 张参考图,最多 7 个主体。
功能
- 编辑一张图片或组合最多 10 张参考图,在提示词中用
@Image1、@Image2… 引用。 - 主体(
kling_elements):最多 7 个角色或物体,每个 2–4 个角度,用@Element1、@Element2… 引用。 - 原生 2K、4K、8K 输出;最多 9 张图片或 2–10 张连贯组图。
必填参数
prompt(string):编辑指令。1–50,000 个字符的文本。用@Image1、@Image2引用参考图,用@Element1、@Element2引用主体。image_urls(string[]):1–10 张参考图。第一个 URL 是@Image1,第二个是@Image2,依此类推。每张图片须是公开可访问的 HTTP(S) URL,最大 30 MB,宽和高都至少 300 像素,宽高比(宽 / 高)在 0.4 到 2.5 之间。
可选参数
kling_elements(object[]):最多 7 个主体。每个主体为{"element_input_urls": [...]},包含同一角色或物体的 2–4 张图:第一张为正面,之后是 1–3 个其他角度。图片限制与image_urls相同。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):为true时生成n张主体和风格一致的连贯组图。默认false。n(integer):图片数量。enable_sequential为false时为 1–9(默认 1),为true时为 2–10(默认 4)。
分辨率
resolution | 尺寸示例 |
|---|---|
2K | 1:1 下为 2048x2048 |
4K | 16:9 下为 5440x3072 |
8K | 1:1 下为 8192x8192 |
示例
- 参考图加主体:把三个角度的角色放进客厅照片,
2K。 - 组合图片:把
@Image2中的物体放进@Image1。 - 基于参考图的组图:同一房间的四个时段,
enable_sequential: true,4K。
注意事项
- 缺少
image_urls、超过 10 张图片、超过 7 个主体、某个主体少于 2 张或多于 4 张图,或图片与主体合计超过 10 个,都会返回 400。 - 不满足尺寸限制(30 MB、300 像素、宽高比 0.4–2.5)的参考图会导致任务失败,失败任务会退还积分。
enable_sequential: true时由模型决定组图的最终构成,偶尔返回的图片少于n张。model和callback_url放在请求根级,与input并列。input接收上文列出的字段,其他字段返回 400。- 积分取决于
resolution和图片数量(n),每张参考图和每个主体另有加价,每个任务只收一次。组图实际返回的图片少于n时,任务完成后退还缺少图片的积分。任务失败会全额退还。当前费率见定价页。
请求体
application/json