动作控制
POST
/kling/v1/videos/motion-control
基于参考图像与参考视频,生成动作控制视频任务。
Authorizations
bearer
Type
HTTP (bearer)
Request Body
application/json
model_name
string
默认 kling-v2-6、kling-v3
prompt
string
文本提示词,可包含正向描述和负向描述。
可通过提示词为画面增加元素、实现运镜效果等,详见可灵「动作控制」使用指南:
https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
不能超过 2500 个字符。
image_url
string
Required
参考图像(Base64 或可访问的图片 URL),用于约束人物、背景等元素。
支持 .jpg / .jpeg / .png;文件大小不超过 10MB。
宽高不小于 300px,宽高比介于 1:2.5 ~ 2.5:1。
video_url
string
Required
参考视频(可访问的 URL)。
支持 .mp4 / .mov;文件大小不超过 100MB。
长宽边长均位于 340px~3850px。
时长不短于 3 秒;上限与人物朝向参考(character_orientation)有关。
keep_original_sound
string
是否保留参考视频原声。
枚举值:yes,no。
character_orientation
string
Required
生成视频中人物朝向参考来源。
枚举值:image,video。
- image:与图片一致(参考视频时长不超过 10 秒)
- video:与视频一致(参考视频时长不超过 30 秒)
mode
string
Required
生成视频的模式。
枚举值:std,pro。
- std:标准模式(性价比高)
- pro:专家模式(高品质)
element_list
object[]
主体参考列表
Expand
watermark_info
object[]
是否同时生成含水印的结果
Expand
callback_url
string
external_task_id
string
Responses
OK
application/json
object