Skip to main content
  • 路径 POST /kling/v1/videos/motion-control
  • 与官网一致：本页请求体、字段命名与返回结构与可灵官网保持一致
  • 字段详解：请参考官网权威文档
请求参数
参数类型必填说明
model_namestring否模型名称，仅支持 kling-v2-6、kling-v3，默认 kling-v2-6
promptstring否文本提示词，可用于补充元素或运镜描述
image_urlstring是参考图片 URL 或 Base64
video_urlstring是参考动作视频 URL
element_listarray否主体引用列表，当前最多 1 个主体
keep_original_soundstring否是否保留原声：yes、no，默认 yes
character_orientationstring是人物朝向：image、video
modestring是生成模式：std、pro
watermark_infoobject否是否生成含水印结果
callback_urlstring否回调通知地址
external_task_idstring否自定义任务 ID
element_list 格式 
{
  "element_list": [
    {
      "element_id": 829836802793406551
    }
  ]
}
补充约束
  • character_orientation=image 时，参考视频时长不得超过 10 秒；
  • character_orientation=video 时，参考视频时长不得超过 30 秒；
  • keep_original_sound 仅支持 yes / no；
  • mode 仅支持 std / pro；
  • model_name 仅支持 kling-v2-6 / kling-v3。

​
场景：参考图片 + 参考动作视频生成视频

curl --request POST \
  --url https://models.hingnet.com.cn/kling/v1/videos/motion-control \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model_name": "kling-v2-6",
    "image_url": "https://example.com/ref.png",
    "prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
    "video_url": "https://example.com/motion.mp4",
    "keep_original_sound": "yes",
    "character_orientation": "image",
    "mode": "pro",
    "external_task_id": "motion-demo-001"
  }'
示例响应 
{
  "code": 0,
  "message": "success",
  "request_id": "req_1735558800_motion123",
  "data": {
    "task_id": "task_01JGHN...",
    "task_info": {
      "external_task_id": "motion-demo-001"
    },
    "task_status": "submitted",
    "created_at": 1735558800000,
    "updated_at": 1735558800000
  }
}
任务查询 
# 查询单个任务
curl "https://models.hingnet.com.cn/kling/v1/videos/motion-control/$TASK_ID" \
  -H "Authorization: Bearer $TOKEN"

# 查询任务列表
curl "https://models.hingnet.com.cn/kling/v1/videos/motion-control?pageNum=1&pageSize=30" \
  -H "Authorization: Bearer $TOKEN"