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

# Veo 3.1 & Veo 3.1 Fast & Veo 3.1 Lite

Veo 3.1 是谷歌最新的高端视频生成模型，能够生成时长 8 秒、分辨率为 720p 或 1080p 的高保真视频，画面逼真且配有原生生成的音频。

Veo 3.1 在多种视觉和电影风格上表现卓越，同时带来了多项全新功能：

* 视频扩展：对之前用 Veo 生成的视频进行延长；
* 首尾帧生成视频：通过提供首尾帧图像生成视频；
* 基于图像的指导：最多使用三张参考图片来引导生成的视频内容。

Veo 3.1 Fast 版本让开发者能够在保证高质量的前提下，更快生成带声音的视频，且针对速度和商业需求进行了优化。它们非常适合用于程序化生成广告的后端服务、快速进行创意概念 A/B 测试的工具，或需要迅速制作社交媒体内容的应用。

你可以通过极客智坊视频生成 API 以编程方式调用该模型，下面是具体的使用示例。

### 模型参数

### 模型参数

* 模型ID：`veo-3.1-generate-preview`/`veo-3.1-fast-generate-preview`/`veo-3.1-lite-generate-preview`
* 模型价格：你可以在[模型详情页](https://geekai.co/models/veo-3.1-generate-preview)查看最新价格信息
* 调用入口：`https://geekai.co/api/v1/videos/generations`
* 模型参数：参考[视频 API 手册](https://docs.geekai.co/cn/api/video/generations.md)
* API认证：[获取 API KEY](https://docs.geekai.co/cn/docs/quick_start.md)

> [!NOTE]
>
> 不支持视频公共 API 中的以下参数：
>
> * `size`
> * `fps`（Veo 3.1 系列模型默认 24 fps，且不可更改）
> * `watermark`
>
> 附：[Veo 3.1 官方 API 文档](https://ai.google.dev/gemini-api/docs/video)

Veo 3.1 支持的 `aspect_ratio` 宽高比如下：

* `16:9`：横屏（默认值）
* `9:16`：竖屏

Veo 3.1 支持的 `resolution` 分辨率如下：

* `720p`：标清（默认值）
* `1080p`：高清
* `4k`：超清（Veo 3.1 Lite 不支持该分辨率）

Veo 3.1 官方线路支持的 `duration` 视频时长如下：

* `4` 秒（默认值）
* `6` 秒
* `8` 秒

### 模型价格

Veo 3.1 生成视频按时长和分辨率计费，以下是 Veo 3.1 的价格表：

| 模型 | 分辨率 | 价格（单位：元/秒） |
| - | - | - |
| Veo 3.1 | 720p | 3.00 |
| Veo 3.1 | 1080p | 3.00 |
| Veo 3.1 | 4k | 4.50 |
| Veo 3.1 Fast | 720p | 0.75 |
| Veo 3.1 Fast | 1080p | 0.90 |
| Veo 3.1 Fast | 4k | 2.25 |
| Veo 3.1 Lite | 720p | 0.375 |
| Veo 3.1 Lite | 1080p | 0.60 |

使用极客智坊提供的[低价代理渠道](https://docs.geekai.co/cn/docs/model_price.md)调用时，不同参数对应价格按照价格表x对应的折扣值即可：以高可用速度优先渠道为例，折扣值是 `0.8`，那么生成 4 秒、分辨率为 `720p` 的 Veo 3.1 Flash 视频价格是 `0.75 x 4 x 0.8 = 2.4` 元，如果生成同样分辨率的 Veo 3.1 视频价格是 `3.00 x 4 x 0.8 = 9.6` 元。其他参数依次类推。

### 内容限制

* 不生成成人内容，仅限适合 18 岁以下观众的内容（未来将提供可绕过此限制的设置）
* 受版权保护的角色和音乐都将被拒绝
* 无法生成真实人物，包括公众人物
* 目前，包含人脸的图像输入会被拒绝

请确保您的提示、参考图像和文字记录都符合这些规则，以避免生成失败。

### 文生视频

```bash theme={null}
curl --location 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "prompt": "生成一段小猫在火星散步的视频",
    "model": "veo-3.1-fast-generate-preview",
    "async": true
}'
```

> [!NOTE]
>
> 如果你想要设置生成视频的分辨率和宽高比，请通过 `resolution` 和 `aspect_ratio` 参数显式传递，对于官方线路还可以通过 `duration` 参数设置视频时长，具体支持的参数值请参考上面的模型参数部分。

### 查询结果

通过异步响应中的任务 ID（`task_id`）可查询视频生成状态：

```bash theme={null}
curl --location --request GET 'https://geekai.co/api/v1/videos/fbdf2778-3d6e-4760-b256-bbfe1ebfe3d1' \
--header 'Authorization: Bearer $GEEKAI_API_KEY'
```

如果视频还在生成中，响应结果如下：

```json theme={null}
{
    "model": "veo-3.1-fast-generate-preview",
    "task_id": "fbdf2778-3d6e-4760-b256-bbfe1ebfe3d1",
    "task_status": "running"
}
```

当视频生成完成后，响应结果如下：

```json theme={null}
{
    "model": "veo-3.1-fast-generate-preview",
    "task_id": "fbdf2778-3d6e-4760-b256-bbfe1ebfe3d1",
    "task_status": "succeed",
    "video_result": [
        {
            "url": "https://static.geekai.co/video/2025/11/28/a272281368ad541d1fbcaf77e2b103b6.mp4"
        }
    ]
}
```

通过 `video_result` 中的 URL 即可获取生成的视频，该视频链接默认有效期为 7 天，请及时下载保存。

### 基于首尾帧生成视频

你可以通过 `image` 参数指定视频的首帧图像，通过 `image_tail` 参数指定视频的尾帧图像，模型会根据这两张图像生成一段过渡视频：

```bash theme={null}
curl --location 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "prompt": "根据下面的首尾帧图片生成一段大黄蜂从汽车变成机器人的视频",
    "image": "https://static.geekai.co/storage/2025/07/04/ec7eae8d6f4540a6b02b027ff8bc7a70.jpeg",
    "image_tail": "https://static.geekai.co/storage/2025/07/04/20250704145107.jpg",
    "model": "veo-3.1-generate-preview",
    "async": true
}'
```

如果仅传递 `image` 参数而不传递 `image_tail` 参数，则表示仅使用首帧生成视频。

> [!NOTE]
>
> 仅 `veo-3.1-generate-preview` 模型支持该功能。

获取视频生成结果的方式与前面介绍的文生视频相同，不再赘述。

### 基于多张参考图生成视频

Veo 3.1 现在最多支持使用 3 张参考图片来引导生成视频的内容。您可以提供人物、角色或产品的图片，以确保生成视频中主体的外观得以保留。

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "veo-3.1-generate-preview",
    "prompt": "[图1]戴着眼镜穿着蓝色T恤的男生和[图2]的柯基小狗，坐在[图3]的草坪上，3D卡通风格",
    "images": [
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_1.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_2.png",
        "https://ark-project.tos-cn-beijing.volces.com/doc_image/seelite_ref_3.png"
    ],
    "async": true
}'
```

> [!NOTE]
>
> 仅 `veo-3.1-generate-preview` 模型支持该功能。

### 视频延长

使用 Veo 3.1 可将之前使用 Veo 生成的视频延长 7 秒，最多可延长 20 次：

```bash theme={null}
curl --location --request POST 'https://geekai.co/api/v1/videos/generations' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer $GEEKAI_API_KEY' \
--data '{
    "model": "veo-3.1-fast-generate-preview",
    "prompt": "追踪这只小猫，它转到一块大的火星岩石背后抓一只老鼠",
    "video": "https://static.geekai.co/video/2026/07/23/150423f07dd2c229cc7936d0b59f81ac.mp4",
    "async": true
}'
```

> [!NOTE]
>
> 仅 `veo-3.1-generate-preview` 和 `veo-3.1-fast-generate-preview` 模型支持该功能。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.