动作控制

以下内容来自 Apifox 快照，可能包含兼容层字段或旧示例；公开调用请以本页的协议说明和当前模型列表为准。

{
  "id": 495899825,
  "name": "动作控制",
  "type": "http",
  "serverId": "",
  "preProcessors": [],
  "postProcessors": [],
  "inheritPreProcessors": {},
  "inheritPostProcessors": {},
  "description": "",
  "operationId": "",
  "sourceUrl": "",
  "method": "post",
  "path": "/kling/v1/videos/motion-control",
  "tags": [],
  "status": 1,
  "requestBody": {
    "type": "application/json",
    "parameters": [],
    "jsonSchema": {
      "type": "object",
      "properties": {
        "prompt": {
          "type": "string",
          "description": "文本提示词，可包含正向描述和负向描述\n可通过提示词为画面增加元素、实现运镜效果等，详见可灵「动作控制」使用指南\n不能超过2500个字符\nhttps://docs.qingque.cn/d/home/eZQAl5y8xNSkr0iYUS8-bpGvP?identityId=2Cn18n4EIHT#section=h.xtmfpd68o18"
        },
        "image_url": {
          "type": "string",
          "description": "参考图像，生成视频中的人物、背景等元素均已参考图为准\n视频内容需满足以下要求：\n人物可以是写实风格人物或与自然人身材比例相似的卡通风格人物，避免遮挡；写实风格人物效果更好\n图像中人物面积需超过图像面积的5%\n包含支持传入图片Base64编码或图片URL（确保可访问）\n图片格式支持.jpg / .jpeg / .png\n图片文件大小不能超过10MB，图片宽高尺寸不小于300px，图片宽高比介于1:2.5 ~ 2.5:1之间"
        },
        "keep_original_sound": {
          "type": "string",
          "description": "可选择是否保留视频原声\n枚举值：yes，no\n其中yes：保留视频原声\n其中no：不保留视频原声"
        },
        "character_orientation": {
          "type": "string",
          "description": "生成视频中人物的朝向，可选择与图片一致或与视频一致\n枚举值：image，video，其中：\n其中image：与图片中人物朝向一致；此时参考视频时长不得超过10秒；\n其中video：与视频中人物朝向一致；此时参考视频时长不得超过30秒；"
        },
        "mode": {
          "type": "string",
          "description": "生成视频的模式\n枚举值：std，pro\n其中std：标准模式（标准），基础模式，性价比高\n其中pro：专家模式（高品质），高表现模式，生成视频质量更佳"
        },
        "callback_url": {
          "type": "string"
        },
        "external_task_id": {
          "type": "string"
        },
        "video_url": {
          "type": "string",
          "description": "视频内容需满足以下要求：\n有且只能有1个写实风格、全身或上半身、包含头部的人物，避免遮挡\n人物肢体动作与表情动作清晰且不包括空翻、倒立等复杂动作\n动作视频一镜到底，人物始终出现在画面某种，避免切镜、运镜等\n视频文件支持.mp4/.mov，文件大小不超过100MB，仅支持长宽的边长均位于340px~3850px之间，上述校验不通过会返回错误码等信息\n视频时长下限不短于3秒，时长上限与人物朝向参考（character_orientation）有关：\n当人物朝向与视频中人物一致时，视频时长最长可达30秒；\n当人物朝向与图片中人物一致时，视频时长最长可达10秒；\n系统会校验视频内容，如有问题会返回错误码等信息"
        },
        "model_name": {
          "type": "string",
          "description": "默认 kling-v2-6  kling-v3"
        },
        "element_list": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "element_id": {
                "type": "string",
                "description": "引用主体时，生成的视频暂时只能参考视频中的人物朝向\n暂时仅支持引入1个主体"
              }
            },
            "x-apifox-orders": [
              "element_id"
            ]
          },
          "description": "主体参考列表"
        },
        "watermark_info": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "watermark_info": {
                "type": "boolean",
                "description": "true 为生成，false 为不生成\n暂不支持自定义水印"
              }
            },
            "x-apifox-orders": [
              "watermark_info"
            ]
          },
          "description": "是否同时生成含水印的结果"
        }
      },
      "required": [
        "image_url",
        "video_url",
        "character_orientation",
        "mode"
      ],
      "x-apifox-orders": [
        "model_name",
        "prompt",
        "image_url",
        "video_url",
        "element_list",
        "keep_original_sound",
        "character_orientation",
        "mode",
        "callback_url",
        "external_task_id",
        "watermark_info"
      ]
    },
    "examples": [
      {
        "mediaType": "application/json",
        "value": "{\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}"
      }
    ],
    "mediaType": "",
    "oasExtensions": "",
    "required": true,
    "additionalContentTypes": []
  },
  "parameters": {
    "path": [],
    "query": [],
    "cookie": [],
    "header": [
      {
        "id": "zwucU2ZDwf",
        "name": "Content-Type",
        "required": false,
        "enable": true,
        "description": "",
        "type": "string",
        "sampleValue": "application/json"
      },
      {
        "id": "vQE7Dw3XbE",
        "name": "Authorization",
        "required": false,
        "enable": true,
        "description": "",
        "type": "string",
        "sampleValue": "Bearer {{YOUR_API_KEY}}"
      }
    ]
  },
  "commonParameters": {
    "query": [],
    "body": [],
    "cookie": [],
    "header": []
  },
  "auth": {},
  "responses": [
    {
      "id": 121739135,
      "name": "成功",
      "code": 200,
      "contentType": "json",
      "jsonSchema": {
        "type": "object",
        "properties": {},
        "x-apifox-orders": []
      },
      "itemSchema": {},
      "description": "",
      "mediaType": "",
      "headers": []
    }
  ],
  "responseExamples": [],
  "codeSamples": [],
  "projectId": 8662722,
  "moduleId": 8310462,
  "folderId": 92436158,
  "ordering": 0,
  "responsibleId": 0,
  "commonResponseStatus": {},
  "advancedSettings": {
    "disabledSystemHeaders": {}
  },
  "customApiFields": {},
  "oasExtensions": "",
  "mockScript": {},
  "createdAt": "2026-08-02T03:53:34.000Z",
  "updatedAt": "2026-08-06T12:15:55.000Z",
  "creatorId": 2863449,
  "editorId": 2863449,
  "creatorUserId": 2863449,
  "editorUserId": 2863449,
  "responseChildren": [],
  "visibility": "INHERITED",
  "securityScheme": {},
  "callbacks": ""
}