动作控制

POSThttps://www.aipro2.com/kling/v1/videos/motion-control

Header 参数

• Content-Typestring
  请求体 Content-Type，一般为 application/json

  示例application/json
• Authorizationstring
  Bearer API Key

  示例Bearer {{YOUR_API_KEY}}

请求体参数

application/json

• callback_urlstring
• character_orientation*string
  生成视频中人物的朝向，可选择与图片一致或与视频一致
  枚举值：image，video，其中：
  其中image：与图片中人物朝向一致；此时参考视频时长不得超过10秒；
  其中video：与视频中人物朝向一致；此时参考视频时长不得超过30秒；
• element_listarray<object>
  主体参考列表
• external_task_idstring
• image_url*string
  参考图像，生成视频中的人物、背景等元素均已参考图为准
  视频内容需满足以下要求：
  人物可以是写实风格人物或与自然人身材比例相似的卡通风格人物，避免遮挡；写实风格人物效果更好
  图像中人物面积需超过图像面积的5%
  包含支持传入图片Base64编码或图片URL（确保可访问）
  图片格式支持.jpg / .jpeg / .png
  图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间
• keep_original_soundstring
  可选择是否保留视频原声
  枚举值：yes，no
  其中yes：保留视频原声
  其中no：不保留视频原声
• mode*string
  生成视频的模式
  枚举值：std，pro
  其中std：标准模式（标准），基础模式，性价比高
  其中pro：专家模式（高品质），高表现模式，生成视频质量更佳
• model_namestring
  默认 kling-v2-6 kling-v3
• promptstring
  文本提示词，可包含正向描述和负向描述
  可通过提示词为画面增加元素、实现运镜效果等，详见可灵「动作控制」使用指南
  不能超过2500个字符
  https://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18
• video_url*string
  视频内容需满足以下要求：
  有且只能有1个写实风格、全身或上半身、包含头部的人物，避免遮挡
  人物肢体动作与表情动作清晰且不包括空翻、倒立等复杂动作
  动作视频一镜到底，人物始终出现在画面某种，避免切镜、运镜等
  视频文件支持.mp4/.mov，文件大小不超过100MB，仅支持长宽的边长均位于340px~3850px之间，上述校验不通过会返回错误码等信息
  视频时长下限不短于3秒，时长上限与人物朝向参考（character_orientation）有关：
  当人物朝向与视频中人物一致时，视频时长最长可达30秒；
  当人物朝向与图片中人物一致时，视频时长最长可达10秒；
  系统会校验视频内容，如有问题会返回错误码等信息
• watermark_infoarray<object>
  是否同时生成含水印的结果

响应

application/json

无响应结构说明

请求体示例示例 1

1{
2    "model_name": "kling-v3",
3    // "image_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png",
4    "prompt": "女孩穿着灰色宽松T恤和牛仔短裤",
5    "video_url": "https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4",
6    "keep_original_sound": "yes",
7    // "character_orientation": "image",
8    "mode": "pro",
9    // "callback_url": "",
10    // "external_task_id": "xxx"
11}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/kling/v1/videos/motion-control" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '"{\r\n    \"model_name\": \"kling-v3\",\r\n    // \"image_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/multi-3.ng.png\",\r\n    \"prompt\": \"女孩穿着灰色宽松T恤和牛仔短裤\",\r\n    \"video_url\": \"https://p2-kling.klingai.com/kcdn/cdn-kcdn112452/kling-qa-test/dance.mp4\",\r\n    \"keep_original_sound\": \"yes\",\r\n    // \"character_orientation\": \"image\",\r\n    \"mode\": \"pro\",\r\n    // \"callback_url\": \"\",\r\n    // \"external_task_id\": \"xxx\"\r\n}"'

响应示例 · 200example

1{2  "code": 0,3  "data": {4    "task_id": "task_example_001"5  },6  "message": "success"7}