Kling
多图参考生视频
DeerAPI 多图参考生视频接入说明：聚焦 Kling multi-image2video 的多图输入、固定 model_name、查询与回调流程。
POST
/
kling
/
v1
/
videos
/
multi-image2video
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/multi-image2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v1-6",
"duration": "5",
"image_list": [
{"image": "https://example.com/subject-1.png"},
{"image": "https://example.com/subject-2.png"}
],
"prompt": "两位主角一起转身看向镜头，然后向前走。",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"task_status_msg": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": {
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
},
"created_at": 123,
"updated_at": 123
}
}/kling/v1/videos/multi-image2video 适合先用多张参考图锁定同一主体，再把它们组织成一段视频。人物、商品或 IP 形象需要较强一致性时，这页比单张图起稿更合适。
推荐流程
决定结果回收方式
想自己轮询时走 查询任务。想直接落库时，在创建阶段就配置 Callback 协议。
model_name 是这条路由的关键输入之一。第一次排错时，不要同时更换参考图集合和模型版本。常见误解
- 把不同主体或差异很大的服装图混在同一个
image_list里。 - 只有一张参考图，却直接走多图视频接口。
- 把这条路由当成“首尾帧”接口；如果你只有开头或结尾控制需求，优先看 图生视频。
相关页面
- 图生视频：只有一张首帧或首尾帧时更合适。
- 视频延长：多图视频生成出第一段后继续续写。
- 查询任务：多图视频提交后按通用视频任务轮询。
- Callback 协议：需要异步回调时使用。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Body
application/json
请求体沿用官方 Kling 字段语义；其中 model_name 仍然是官方模型名，不是 DeerAPI live capability ID。
kling-v1-6
生成视频时长，单位秒，可选，枚举值：5，10（包含尾帧的请求仅支持5秒）
最多支持 4 张图片。支持可访问的图片 URL 或原始 Base64 编码；如果你使用 Base64，请不要携带 data:image/...;base64, 前缀，直接传 <BASE64_IMAGE_DATA> 即可。图片格式支持 .jpg / .jpeg / .png，大小不超过 10MB，宽高不小于 300px，宽高比需在 1:2.5 到 2.5:1 之间。
Show child attributes
Show child attributes
正向文本提示， 可选，不能超过500个字符
负向文本提示，可选，不能超过200个字符
本次任务结果回调通知地址，可选
生成视频的模式，可选，枚举值：std（高性能）或 pro（高表现）
生成视频的自由度，可选，值越大相关性越强，取值范围：[0, 1]
静态画笔应用区域（用户使用动态画笔应用的遮罩图像）
动态刷配置列表 可配置多个组（最多 6 个），每个组包含一系列 “涂抹区域遮罩 ”和 “运动轨迹”。
Show child attributes
Show child attributes
自定义任务 ID 用户自定义的任务 ID，传入后不会覆盖系统生成的任务 ID，但支持通过此 ID 查询任务 请注意，在单用户情况下需要保证唯一性。
⌘I
cURL
Copy
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/multi-image2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v1-6",
"duration": "5",
"image_list": [
{"image": "https://example.com/subject-1.png"},
{"image": "https://example.com/subject-2.png"}
],
"prompt": "两位主角一起转身看向镜头，然后向前走。",
"callback_url": "https://example.com/kling/callback"
}'Copy
{
"code": 123,
"message": "<string>",
"request_id": "<string>",
"data": {
"task_id": "<string>",
"task_status": "<string>",
"task_status_msg": "<string>",
"task_info": {
"external_task_id": "<string>"
},
"task_result": {
"videos": {
"id": "<string>",
"url": "<string>",
"duration": "<string>"
}
},
"created_at": 123,
"updated_at": 123
}
}