动作控制 + file_infos

开发中

POST

/v1/videos

动作控制 + file_infos

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数application/json必填

示例

{
  "model": "Kling-3.0-Omni",
  "prompt": "让人物按参考视频动作运动",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "file_infos": [
      {
        "type": "Url",
        "category": "Video",
        "url": "https://example.com/motion-ref.mp4"
      }
    ],
    "output_config": {
      "duration": 5,
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.xgapi.top/v1/videos' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "model": "Kling-3.0-Omni",
  "prompt": "让人物按参考视频动作运动",
  "seconds": "5",
  "metadata": {
    "scene_type": "motion_control",
    "motion_level": "pro",
    "file_infos": [
      {
        "type": "Url",
        "category": "Video",
        "url": "https://example.com/motion-ref.mp4"
      }
    ],
    "output_config": {
      "duration": 5,
      "resolution": "720P",
      "aspect_ratio": "16:9"
    }
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "id": "task_uS28Df3npjkcVE8FfH9JQcvjWKxUgrsG",
    "model": "kling-2.6-motion-std-720p",
    "object": "video",
    "status": "in_progress",
    "task_id": "task_xKFlPhfIcFR1dKWSr9akbE59umufNdju",
    "progress": 0,
    "created_at": 1780891541,
    "completed_at": 1780891544
}

修改于 2026-06-08 06:31:31

参考视频高级透传（file_infos）

ExtInfo 多镜头（Kling-3.0 高级）