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

# Video introduction

# Gemini 视频生成

使用 Google 的 **Veo 2 / Veo 3 / Veo 3.1** 模型生成与编辑视频。支持文生视频、图生视频、时长延长、重拍以及物体插入/移除。

## 支持的模型

| 模型                           | 说明                                             |
| ---------------------------- | ---------------------------------------------- |
| `veo31_fast`                 | Veo 3.1 Fast —— 最新版，推荐大多数场景使用                  |
| `veo31_quality`              | Veo 3.1 Quality —— 最高质量                        |
| `veo31_fast_ingredients`     | Veo 3.1 Fast，支持 1-3 张参考图（ingredients-to-video） |
| `veo3_fast` / `veo3_quality` | Veo 3 生成                                       |
| `veo2_fast` / `veo2_quality` | Veo 2 生成（旧版）                                   |

## 功能特性

<CardGroup cols={2}>
  <Card title="文生视频" icon="wand-magic-sparkles">
    通过 `action: "text2video"` 从文本提示词创建视频
  </Card>

  <Card title="图生视频" icon="images">
    使用 1-2 张参考图（起始帧/起始+结束帧），设置 `action: "img2video"`
  </Card>

  <Card title="Ingredients 合成视频" icon="layer-group">
    使用 1-3 张参考图组合场景，设置 `action: "ingredients2video"`
  </Card>

  <Card title="超分与延长" icon="up-right-and-down-left-from-center">
    提升到 1080p/4K、生成 GIF 或延长视频时长
  </Card>

  <Card title="重拍" icon="camera-rotate">
    使用不同的摄像机运动重新生成视频（15 种运动类型）
  </Card>

  <Card title="物体编辑" icon="scissors">
    通过蒙版在视频中插入或移除物体
  </Card>
</CardGroup>

## 使用流程

<Steps>
  <Step title="创建视频任务">
    调用 `POST /gemini/video/generate`，传入提示词和模型，返回 `taskId`。
  </Step>

  <Step title="轮询任务结果">
    使用 `GET /gemini/task/result?taskId=xxx` 轮询直到 status 为 `completed`，结果中包含视频 URL。
  </Step>

  <Step title="二次处理（可选）">
    使用返回的 `videoId` 进行超分、延长、重拍或物体编辑。
  </Step>
</Steps>

## 可用端点

### 生成

| 端点                            | 方法   | 描述                   |
| ----------------------------- | ---- | -------------------- |
| `/gemini/video/generate`      | POST | 从文本或图像创建视频           |
| `/gemini/video/prompt/expand` | POST | 将简短提示词扩展为电影级描述（同步返回） |

### 后处理

| 端点                       | 方法   | 描述                   |
| ------------------------ | ---- | -------------------- |
| `/gemini/video/upsample` | POST | 提升到 1080p/4K 或生成 GIF |
| `/gemini/video/extend`   | POST | 延长视频时长（仅 Veo 3.1）    |
| `/gemini/video/reshoot`  | POST | 使用不同摄像机运动重新生成        |

### 物体编辑

| 端点                            | 方法   | 描述       |
| ----------------------------- | ---- | -------- |
| `/gemini/video/object/insert` | POST | 在视频中插入物体 |
| `/gemini/video/object/remove` | POST | 从视频中移除物体 |

### 任务管理

视频与图像共用同一轮询端点 — 见[获取任务结果](/zh/api-reference/gemini/task)。

| 端点                    | 方法  | 描述                          |
| --------------------- | --- | --------------------------- |
| `/gemini/task/result` | GET | 通过 taskId 获取任务结果（视频**与**图像） |

***

### 浏览 API 文档

* [生成视频](video) —— 文生视频、图生视频、ingredients 合成视频
* [视频超分](upsample) —— 提升到 1080p/4K 或生成 GIF
* [扩展提示词](prompt-expand) —— 增强提示词以获得更好的效果
* [视频重拍](reshoot) —— 改变摄像机运动
* [延长视频](extend) —— 延长视频时长
* [插入物体](object-insert) —— 在视频中添加物体
* [移除物体](object-remove) —— 从视频中移除物体
* [获取任务结果](/zh/api-reference/gemini/task) —— 视频与图像共用查询