文生视频

POST

/v1/videos

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数application/json必填

示例

{
  "model": "veo-3.1-generate-preview",
  "prompt": "黄昏海边的灯塔，镜头缓慢推进，海浪轻拍礁石，电影级光影，稳定运镜",
  "duration": 8,
  "size": "1280x720",
  "metadata": {
    "negativePrompt": "blurry, watermark, distorted, low quality",
    "resolution": "720p",
    "aspectRatio": "16:9",
    "seed": 20260401
  }
}

请求示例代码

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": "veo-3.1-generate-preview",
  "prompt": "黄昏海边的灯塔，镜头缓慢推进，海浪轻拍礁石，电影级光影，稳定运镜",
  "duration": 8,
  "size": "1280x720",
  "metadata": {
    "negativePrompt": "blurry, watermark, distorted, low quality",
    "resolution": "720p",
    "aspectRatio": "16:9",
    "seed": 20260401
  }
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "task_id": "task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "veo-3.1-generate-preview",
  "status": "queued",
  "progress": 0,
  "created_at": 1775025000
}

修改于 2026-05-20 14:23:54

状态码说明和注意事项

图生视频