动作控制(Motion Control)
用一段「动作参考视频」驱动「形象参考图」中的人物,生成动作与参考视频一致的视频;kling-video-motion-control-v3.0 还可通过元素(Element)直接指定定制角色。本接口无 duration 参数,输出时长跟随动作参考视频。
端点
- 提交:
POST /kling/v1/videos/text2video(与文生视频共用入口,网关按模型自动路由到上游动作控制端点) - 查询:
GET /kling/v1/videos/text2video/{task_id},见查询与下载
模型:kling-video-motion-control-v3.0、kling-video-motion-control-v2.6。
请求体
metadata.contents 数组元素:
动作参考视频的时长上限与 character_orientation 相关:image(朝向与图片一致)参考视频最长 10 秒;video(朝向与视频一致)最长 30 秒。动作过快或难度高时,可能生成短于上传时长的视频(模型仅提取有效动作时长,最短提取 3 秒即可生成),计费以输出视频时长为准。
请求示例
形象参考图:人物比例尽量与参考视频中人物一致(避免全身动作驱动半身人物),人物需露出清晰的上半身或全身肢体及头部,避免遮挡与倒立、平卧等极端朝向;支持真实 / 风格化角色。动作参考视频:建议单人动作(多人时取画面占比最大者)、真人动作、一镜到底且角色始终在画面中,避免切镜与运镜(否则会被截取)。素材 URL 必须是公网可直接下载的直链。
响应体
提交成功返回可灵格式任务对象(同提交任务响应体),data.task_id 用于查询。查询状态流转、task_result.videos 结构与计费回显(final_unit_deduction)均与文生 / 图生视频一致,见查询与下载。
响应示例
实测口径(v3.0,720p + audio:"original",约 3 分钟出片):成片分辨率跟随 720p 档(1264×720,画幅跟随素材比例)、时长跟随动作参考视频(5.08s → 5.03s)、final_unit_deduction 450000。成片为上游签名直链,约 45 分钟后失效,请及时下载转存;参考视频本身无声时,audio:"original" 输出同样无声。模型名与价格以模型广场为准,计费按任务完成时的实际用量结算(失败自动退还)。
