# Veo 3.1 模型

Veo 3.1、Fast 和 Lite 的模式、输入、默认值、积分价格和 API 示例。

## 概览

**厂商：** Google。`veo-3-1`、`veo-3-1-fast` 和 `veo-3-1-lite` 支持文本、图片、首尾帧和参考图工作流。输出始终包含原生音频，没有音频开关。

## 模式与输入

三个模型的模式、输入和选项相同。

| 模式                 | `image_urls`            | `video_urls` |
| -------------------- | ----------------------- | ------------ |
| `text-to-video`      | 无                      | 无           |
| `image-to-video`     | 恰好 1 张               | 无           |
| `frames-to-video`    | 恰好 2 张（首帧、尾帧） | 无           |
| `reference-to-video` | 1–3 张                  | 无           |

| 选项           | 取值                   | 默认值 |
| -------------- | ---------------------- | ------ |
| `duration`     | 不支持（省略）         | —      |
| `resolution`   | `720p`、`1080p`、`4k`  | `720p` |
| `aspect_ratio` | `16:9`、`9:16`、`Auto` | `16:9` |
| `audio`        | 拒绝 `true`            | —      |

Veo 视频长度固定，发送 `duration` 会返回 `400`。

## 积分价格

按次计价，所有模式相同。

| 模型           | 720p | 1080p | 4k  |
| -------------- | ---- | ----- | --- |
| `veo-3-1`      | 225  | 240   | 285 |
| `veo-3-1-fast` | 30   | 40    | 100 |
| `veo-3-1-lite` | 15   | 35    | 75  |

## 示例

```bash
curl -X POST https://viewmax.studio/api/v1/videos \
  -H "Authorization: Bearer $VIEWMAX_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: veo-example-0001" \
  -d '{
    "model": "veo-3-1-fast",
    "mode": "frames-to-video",
    "prompt": "A smooth transition from the first frame to the last",
    "image_urls": [
      "https://example.com/first.png",
      "https://example.com/last.png"
    ],
    "options": { "resolution": "1080p", "aspect_ratio": "16:9" }
  }'
```

该请求消耗 40 积分。通过 MCP 时，调用 `generate_video`，使用相同的模型 ID，且不要传 `duration`。

## 说明

- `veo-3-1` 的 `reference-to-video` 实际由 Veo 3.1 Fast 渲染，但仍按 `veo-3-1` 价格计费。参考图工作流请使用 `veo-3-1-fast` 或 `veo-3-1-lite`。
- `Auto` 表示由模型选择画面比例。