DeerAPI 图生视频接入说明:通过统一网关调用 Kling image2video,说明首帧、尾帧、model_name 与查询回调的关系。
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/image2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-master",
"image": "https://example.com/start-frame.png",
"prompt": "镜头缓慢推近,人物抬头微笑。",
"duration": "5",
"mode": "pro",
"callback_url": "https://example.com/kling/callback"
}'{
"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/image2video 适合把一张静态图扩展成连续镜头。海报、商品图、角色设定图已经明确时,通常先从这页开始。
保存任务并取结果
task_id。你可以用 查询任务 轮询,也可以直接配置 Callback 协议。kling_video 是 DeerAPI capability,不是请求体里的 model_name。如果你要固定 Kling 版本,请显式传官方模型名。image 和 image_tail 当成两套独立参考图集来用。task_id 当成 video_id 交给下游流程。Bearer token authentication. Use your DeerAPI key.
请求体沿用官方 Kling 字段语义;其中 model_name 仍然是官方模型名,不是 DeerAPI live capability ID。
参考图像,必须,支持Base64编码或图片URL,支持.jpg / .jpeg / .png格式,大小不能超过10MB,分辨率不小于300*300px
正向文本提示, 可选,不能超过500个字符
负向文本提示,可选,不能超过200个字符
本次任务结果回调通知地址,可选
生成视频的模式,可选,枚举值:std(高性能)或 pro(高表现)
Default value: kling-v1,Example values:kling-v1,kling-v1-5,kling-v1-6,kling-v2-master
参考图像 - 尾帧控制,可选,支持Base64编码或图片URL,支持.jpg / .jpeg / .png格式,大小不能超过10MB,分辨率不小于300*300px
生成视频的自由度,可选,值越大相关性越强,取值范围:[0, 1]
生成视频时长,单位秒,可选,枚举值:5,10(包含尾帧的请求仅支持5秒)
静态画笔应用区域(用户使用动态画笔应用的遮罩图像)
动态刷配置列表 可配置多个组(最多 6 个),每个组包含一系列 “涂抹区域遮罩 ”和 “运动轨迹”。
Show child attributes
自定义任务 ID 用户自定义的任务 ID,传入后不会覆盖系统生成的任务 ID,但支持通过此 ID 查询任务 请注意,在单用户情况下需要保证唯一性。
curl --request POST \
+ --url https://api.deerapi.com/kling/v1/videos/image2video \
+ --header 'Authorization: Bearer <DEERAPI_KEY>' \
+ --header 'Content-Type: application/json' \
+ --data '{
"model_name": "kling-v2-master",
"image": "https://example.com/start-frame.png",
"prompt": "镜头缓慢推近,人物抬头微笑。",
"duration": "5",
"mode": "pro",
"callback_url": "https://example.com/kling/callback"
}'{
"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
}
}