Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称:kling-v3-motion-controlkling-v2-6-motion-control
string
文本提示词,用于补充动作、镜头和风格要求可选但建议填写,描述越具体结果越稳定示例:"人物按参考视频动作起舞,动作连贯,写实风格"
string
必填
参考图片 URL需为公网可访问链接
string
必填
参考视频 URL需为公网可访问直链,建议 mp4/mov 且不超过 100MB
服务端会探测 video_url 实际时长,最短为 3 秒;上限由 character_orientation 决定
string
默认值:"yes"
是否保留参考视频原音轨可选值:
  • yes:保留原音轨(默认)
  • no:不保留原音轨
string
必填
人物朝向控制方式可选值:
  • image:以参考图人物朝向为主(参考视频时长需 3~10s
  • video:以参考视频人物朝向为主(参考视频时长需 3~30s
string
必填
生成模式可选值:
  • std:标准模式(速度和质量均衡)
  • pro:高质量模式(通常更耗时)
object
水印控制对象(可选)

时长规则

计费时长由服务端对 video_url 探测得到的真实时长决定,而非客户端估算值。

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:image 朝向(10 秒内)

场景 2:video 朝向(30 秒内)