参考视频高级透传（file_infos）

开发中

POST

/v1/videos

适用于 Omni / 动作控制等；file_infos 会原样透传官方。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "model": "Kling-3.0-Omni",
  "prompt": "基于参考视频生成同风格镜头",
  "seconds": "5",
  "metadata": {
    "file_infos": [
      {
        "type": "Url",
        "category": "Video",
        "url": "https://example.com/ref-video.mp4",
        "reference_type": "feature"
      }
    ],
    "output_config": {
      "duration": 5,
      "resolution": "720P",
      "aspect_ratio": "16:9",
      "audio_generation": "Disabled"
    }
  }
}

请求示例代码

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": {
    "file_infos": [
      {
        "type": "Url",
        "category": "Video",
        "url": "https://example.com/ref-video.mp4",
        "reference_type": "feature"
      }
    ],
    "output_config": {
      "duration": 5,
      "resolution": "720P",
      "aspect_ratio": "16:9",
      "audio_generation": "Disabled"
    }
  }
}'

返回响应

🟢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:29:56

对口型

动作控制 + file_infos