> ## Documentation Index
> Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Veo 3.1

> 通过 Crazyrouter 统一视频 API 调用 Veo 3.1 Fast 与 Veo 3.1 Quality

> 更新日期：2026-06-06

# Veo 3.1

当前 Crazyrouter 对客公开的 Veo 3.1 模型为：

* `veo-3.1-fast`
* `veo-3.1-quality`

这两个名称是对客 public alias。内部 canonical provider 名称不会直接暴露给客户。

<Note>
  `veo-3.1` 不是对客可直接提交的 `model` 值。对客请求请始终使用 `veo-3.1-fast` 或 `veo-3.1-quality`。
</Note>

## 通过统一视频 API 调用

```
POST /v1/video/create
```

当前这页只覆盖已经对客收口的能力：

* 文本生视频
* 单图生视频

Google 官方文档中的 `referenceImages`、style reference、以及更细的 provider-native 模式，不属于当前公开 contract。

### 当前可用模型

| 模型                | 说明                 |
| ----------------- | ------------------ |
| `veo-3.1-fast`    | 更偏低延迟，适合更快拿到首个可用结果 |
| `veo-3.1-quality` | 更偏质量优先，适合默认主展示     |

### 能力状态

| 能力 / 规格                              | 状态         | 说明                         |
| ------------------------------------ | ---------- | -------------------------- |
| 文生视频 `720P / 1080P`                  | `Verified` | 当前公开 contract 已收口          |
| 单图生视频 `720P / 1080P`                 | `Verified` | 当前公开 contract 已收口          |
| 音频开启行                                | `Beta`     | 官方能力存在，但当前公开 artifact 仍待补充 |
| `start_end`                          | `Beta`     | 当前公开页尚未承诺                  |
| `referenceImages` / reference assets | `Beta`     | 当前公开页尚未承诺                  |
| `4K`                                 | `Beta`     | 当前公开页尚未承诺                  |

<Note>
  Pricing 页面与这页文档使用同一套状态口径：`Verified` 表示当前已有最小 live 闭环，`Beta` 表示官方能力存在但当前公开验证或边界仍在补充。
</Note>

### 请求参数

| 参数             | 类型      | 必填 | 说明                                 |
| -------------- | ------- | -- | ---------------------------------- |
| `model`        | string  | 是  | `veo-3.1-fast` 或 `veo-3.1-quality` |
| `prompt`       | string  | 是  | 视频描述提示词                            |
| `aspect_ratio` | string  | 否  | 当前公开建议使用 `16:9` 或 `9:16`           |
| `size`         | string  | 否  | 当前公开建议使用 `720P` 或 `1080P`          |
| `images`       | array   | 否  | 单图生视频时传 `1` 张图片 URL                |
| `duration`     | integer | 否  | 常见值为 `8`                           |

### 请求示例

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.crazyrouter.com/v1/video/create \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -d '{
      "model": "veo-3.1-quality",
      "prompt": "A cinematic shot of a spaceship landing on Mars, dust clouds rising, golden hour lighting",
      "aspect_ratio": "16:9"
    }'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.crazyrouter.com/v1/video/create",
      headers={
          "Content-Type": "application/json",
          "Authorization": "Bearer YOUR_API_KEY"
      },
      json={
          "model": "veo-3.1-quality",
          "prompt": "A cinematic shot of a spaceship landing on Mars",
          "aspect_ratio": "16:9"
      }
  )

  task_id = response.json()["task_id"]
  print(f"任务 ID: {task_id}")
  ```
</CodeGroup>

### 响应示例

```json theme={null}
{
  "task_id": "veo_task_abc123",
  "status": "processing"
}
```

***

## 单图生视频示例

```bash cURL theme={null}
curl -X POST https://api.crazyrouter.com/v1/video/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "veo-3.1-fast",
    "prompt": "The person in the image slowly turns their head and smiles",
    "images": ["https://example.com/portrait.jpg"],
    "aspect_ratio": "9:16",
    "size": "720P"
  }'
```

***

## 查询任务

```
GET /v1/video/query?id={task_id}
```

```bash cURL theme={null}
curl "https://api.crazyrouter.com/v1/video/query?id=veo_task_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### 响应示例（已完成）

```json theme={null}
{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "veo_task_abc123",
    "status": "SUCCESS",
    "url": "https://media.crazyrouter.com/task-artifacts/example.mp4",
    "artifact_url": "https://media.crazyrouter.com/task-artifacts/example.mp4"
  }
}
```

<Note>
  Google 官方文档还描述了 Veo 3.1 的 `reference asset images`、以及更细的 provider-native 能力边界。当前 Crazyrouter 对客公开页先只承诺 `veo-3.1-fast` / `veo-3.1-quality` 下的文生视频与单图生视频；如果后续开放更多 Veo 一级能力，会单独补文档与验证记录。
</Note>