Gemini 视频模型格式 - 数字先锋API文档

# Gemini 视频模型格式
Gemini 视频模型，且统一走 /v1/videos/generations
Gemini 视频任务查询，且统一走 /v1/videos/generations/{task_id}

Gemini 视频生成模型包括veo3.1-4k、veo3.1、veo3.1-components-4k、veo3.1-pro、veo3.1-fast
最高支持‌：‌1080p（全高清）‌默认生成为 ‌720p支持选项‌：‌4秒、6秒、8秒‌，支持‌：‌16:9（横屏）‌、‌9:16（竖屏）‌‌不支持‌：‌1:1（方形）‌‌4K原生分辨率‌：支持 ‌3840×2160（4K UHD）‌ 输出

## API 视频生成接口文档

### 基础信息

- 接口地址：`https://api.cxsee.com`
- 认证方式：`Authorization: Bearer {YOUR_API_KEY}`

---

### 1. 提交视频生成任务

```bash
curl --request POST "https://api.cxsee.com/v1/videos/generations" \
  --header "Authorization: Bearer sk-your-api-key" \
  --header "Content-Type: application/json" \
  --data '{
    "model": "veo3.1-fast",
    "prompt": "A cat walking in snow, cinematic",
    "duration": 5
  }'
```

成功返回：

### 2. 查询任务状态

将 `task_id` 拼接到 URL 路径中：

```bash
curl --request GET "https://api.cxsee.com/v1/videos/generations/video_5ee3d84c-0296-47fb-a157-35b3ec263d10" \
  --header "Authorization: Bearer sk-your-api-key"
```

生成中返回：

### 3. 生成完成返回

```json
{
  "id": "video_5ee3d84c-0196-47fb-a157-35b3ec263d10",
  "task_id": "video_5ee3d84c-0196-47fb-a157-35b3ec263d10",
  "object": "video",
  "model": "veo3.1-fast",
  "status": "succeeded",
  "progress": 100,
  "created_at": 1772818237,
  "completed_at": 1772818336,
  "metadata": {
    "url": "https://midjourney-plus.oss-us-west-1.aliyuncs.com/flow/b3003d21-4a36-44c9-938f-d13560365c98.mp4"
  }
}
```

### 4. 错误码参考

认证失败（API Key 无效或缺失）：

```bash
curl --request GET "https://api.cxsee.com/v1/videos/generations/video_xxxxx" \
  --header "Authorization: Bearer sk-invalid-key"
```

```json
{
  "error": {
    "code": "invalid_api_key",
    "message": "无效的令牌",
    "type": "new_api_error"
  }
}
```

完整错误码表：

| 错误码 | HTTP 状态码 | 说明 |
|---|---|---|
| `invalid_api_key` | 401 | API Key 无效或已过期 |
| `insufficient_quota` | 402 | 余额不足 |
| `invalid_request` | 400 | 请求参数错误（如缺少 prompt） |
| `model_not_found` | 404 | 模型名称不存在 |
| `task_not_found` | 404 | 任务 ID 不存在 |
| `rate_limit_exceeded` | 429 | 请求频率超限 |
| `internal_error` | 500 | 服务端内部错误 |

### 注意事项

- `task_id` 放在 URL 路径中，不是放在 Header 里
- 视频生成为异步任务，提交后需轮询查询状态，建议间隔 5-10 秒
- 视频链接在 `metadata.url` 字段中，生成完成后可直接下载

任务日志(异步任务）
![](https://img.cxhao.com/images/5/2026/02/VN85kkmIccUv8l38nf4cN2808vc8fF.png)

```
视频结果
![](https://img.cxhao.com/images/5/2026/02/B9Fs9bSKqZQn9fwbsMDqpqBfTBbTqb.png)

上一篇：Gemini 绘画（官方原生系列）下一篇：Midjourney 绘画模型格式