获取 API Key 获取 API
文档

Kling v2.6 Motion Control 视频生成

- Kling 动作控制模型(参考图 + 参考视频)

  • 动作控制模型,通过统一入口 /v1/videos/generations 调用
  • 支持 image / video 两种人物朝向,最大时长分别为 10s / 30s
  • 视频生成为异步任务,提交后返回 task_id

请求示例

curl --request POST \
  --url https://api.openveer.com/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "kling-v2-6-motion-control",
    "prompt": "保持人物面部特征一致,按参考视频完成转身挥手动作,电影感光影",
    "image_url": "https://example.com/ref-image.png",
    "video_url": "https://example.com/ref-video-8s.mp4",
    "keep_original_sound": "yes",
    "character_orientation": "image",
    "mode": "std",
    "watermark_info": {"enabled": false}
  }'

响应示例

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01J9HA7JPQ9A0Z6JZ3V8M9W6PZ"
    }
  ]
}

认证

Authorization string

所有接口均需要使用 Bearer Token 进行认证

获取 API Key:

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

Authorization: Bearer YOUR_API_KEY

请求参数

model string

视频生成模型名称:kling-v3-motion-control 或 kling-v2-6-motion-control

prompt string

文本提示词,用于补充动作、镜头和风格要求

可选但建议填写,描述越具体结果越稳定

示例:"人物按参考视频动作起舞,动作连贯,写实风格"

image_url string

参考图片 URL

需为公网可访问链接

video_url string

参考视频 URL

需为公网可访问直链,建议 mp4/mov 且不超过 100MB

警告



服务端会探测 video_url 实际时长,最短为 3 秒;上限由 character_orientation 决定

keep_original_sound string

是否保留参考视频原音轨

可选值:

  • yes:保留原音轨(默认)
  • no:不保留原音轨
character_orientation string

人物朝向控制方式

可选值:

  • image:以参考图人物朝向为主(参考视频时长需 3~10s)
  • video:以参考视频人物朝向为主(参考视频时长需 3~30s)
mode string

生成模式

可选值:

  • std:标准模式(速度和质量均衡)
  • pro:高质量模式(通常更耗时)
watermark_info object
水印控制对象(可选)
enabled boolean

是否添加水印

  * true:添加水印
  * false:不添加水印(默认)

时长规则

参数条件 允许的参考视频时长
character_orientation = image 3s ~ 10s
character_orientation = video 3s ~ 30s
注意

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

响应

code integer

响应状态码,成功时为 200

data array
返回数据数组
status string

任务状态,初始提交时为 submitted

task_id string

任务唯一标识符,用于查询任务状态和结果

使用场景

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

{
  "model": "kling-v2-6-motion-control",
  "prompt": "保持人物朝向与参考图一致,完成转身和挥手动作",
  "image_url": "https://example.com/ref-image.png",
  "video_url": "https://example.com/ref-video-8s.mp4",
  "character_orientation": "image",
  "mode": "std",
  "keep_original_sound": "yes",
  "watermark_info": {"enabled": false}
}

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

{
  "model": "kling-v2-6-motion-control",
  "prompt": "跟随参考视频的人物朝向和节奏,保持动作连贯",
  "image_url": "https://example.com/ref-image.png",
  "video_url": "https://example.com/ref-video-12s.mp4",
  "character_orientation": "video",
  "mode": "pro",
  "keep_original_sound": "no",
  "watermark_info": {"enabled": false}
}