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

# VEO 3.1 Official vs 官逆 选型对照

> VEO 3.1 Official（官转）与既有 VEO 3.1（官逆）通道的全维度对比表 + 三步决策树，帮你为不同业务场景选对通道。

<Warning>
  **官逆通道已下线（2026年6月）**：VEO 3.1 官逆通道因 Google Flow 逆向风控原因已暂时下线，当前请使用 **官转**（本系列）通道。本页官逆相关内容暂作保留以供参考，恢复时间请关注后续公告。
</Warning>

<Info>
  API易 同时提供两条 Veo 3.1 通道。本页帮你**按场景选型**：追求官方画质稳定性、能接受异步轮询 → 走 **官转**（本系列）；预算敏感、需要同步流式或首尾帧 → 走 **官逆**（[VEO 3.1](/api-capabilities/veo/overview)）。两条通道可以**同账号并行使用**，不冲突。
</Info>

## 全维度对照表

| 维度 | **官转**（本系列） | **官逆**（[既有 VEO 3.1](/api-capabilities/veo/overview)） |
| - | - | - |
| **通道类型** | 透传 Google AI Studio 官方端点 | 逆向工程接入 Google Flow |
| **模型 ID** | `veo-3.1-generate-preview` / `veo-3.1-fast-generate-preview` | `veo-3.1` / `veo-3.1-fast` / `-landscape` / `-fl` 系列共 8 个变种 |
| **计费方式** | 按次（与时长、分辨率无关） | 按次（与时长、分辨率无关） |
| **价格** | \$0.3（fast）/ \$1.2（standard） | \$0.15（fast）/ \$0.25（standard）— **省 50–75%** |
| **端点路径** | 仅 `POST /v1/videos`（异步） | `POST /v1/chat/completions`（同步流式）+ `POST /v1/videos`（异步） |
| **同步流式** | ❌ 仅异步轮询 | ✅ 支持 `stream: true` 实时见进度 |
| **时长** | 4 / 6 / 8 秒（字符串） | 固定 8 秒 |
| **分辨率** | 720p / 1080p / 4k 三档 | HD 横屏（1280×720）/ 竖屏（720×1280） |
| **参考图** | 1 张 `input_reference`（multipart） | 1–2 张（**支持首尾帧** `-fl` 系列） |
| **横/竖屏切换** | 通过 `aspectRatio` 参数 | 通过模型 ID 选择（`-landscape` 系列） |
| **分组** | `Default` | `Default` |
| **计费模式** | 按次计费 ✅ / 按量优先 ✅（按量计费 ❌） | 按次计费 ✅ / 按量优先 ✅ |
| **响应字段** | `id` / `task_id` / `status` / `progress`（粗粒度 0/50/100） | 同步：完整 chat completion；异步：`task_id` / `status` |
| **失败计费** | ❌ 不计费 | ❌ 不计费 |
| **音频** | 原生同步音轨 | 原生同步音轨 |
| **适用场景** | 追求官方质量稳定、能接受异步轮询的生产场景 | 预算敏感、需要同步流式 UI 进度、需要首尾帧创作 |

## 三步决策树

<Steps>
  <Step title="Q1: 你需要首尾帧（Frame-to-Video）能力吗？">
    * **需要** → 走 **[官逆 VEO 3.1](/api-capabilities/veo/overview)** 的 `-fl` 系列（如 `veo-3.1-landscape-fast-fl`），官转**暂未开放**首尾帧
    * **不需要** → 进入 Q2
  </Step>

  <Step title="Q2: 你的前端需要同步流式进度条吗？">
    * **需要**（用户等待 UI 不能空白） → 走 **[官逆 VEO 3.1](/api-capabilities/veo/overview)** 的 `/v1/chat/completions` 同步流式端点
    * **后端任务化**（队列消费、批量出片） → 进入 Q3
  </Step>

  <Step title="Q3: 你的预算 vs 画质优先级如何？">
    * **预算优先**（\$0.15 vs \$0.3 差距明显）→ 走 **[官逆 VEO 3.1](/api-capabilities/veo/overview)**，单价低 50%
    * **画质 / 稳定性优先**（最终交付、4K 高清、强指令遵循） → 走 **官转**（本系列）的 `veo-3.1-generate-preview`
    * **试水预览** → 走 **官转**的 `veo-3.1-fast-generate-preview`（\$0.3）或 **官逆**的 `-fast`（\$0.15）
  </Step>
</Steps>

## 典型场景配对建议

| 业务场景 | 推荐通道 | 推荐模型 | 理由 |
| - | - | - | - |
| 短视频矩阵批量生产（每天 100+ 条） | **官逆** | `veo-3.1-landscape-fast` | 单价 \$0.15，量产成本可控 |
| 客户广告片最终交付 | **官转** | `veo-3.1-generate-preview` | 官方画质稳定 + 4K 可选 |
| 前端在线展示（要 loading 动效） | **官逆** | `veo-3.1-landscape-fast` + 同步流式 | 可见进度，避免空等焦虑 |
| 静态海报 + 首尾帧 → 动效短片 | **官逆** | `veo-3.1-landscape-fast-fl` | 首尾帧能力 |
| 4K 高清电影感片段（关键素材） | **官转** | `veo-3.1-generate-preview` + `resolution=4k` | 仅官转支持 4K |
| 海外团队接入（现有 Key 不动配置） | **官转** | `veo-3.1-fast-generate-preview` | 默认分组 + 按次，零门槛 |
| 同 prompt 多 seed 探索风格 | **官转** | `veo-3.1-fast-generate-preview` | 4–6 秒可选，试错成本低 |
| 试水 + 最终切换的工作流 | 混用 | 官逆 fast 试水 → 官转 standard 出片 | 试错便宜、交付稳定 |

## 两个通道是否可以混用？

**完全可以**。两个通道是独立路由：

* 同一账号下，**同一把令牌**（走默认分组）可以同时调用两个通道，按调用次数分别计费
* 业务代码里按需切 `model` 字段即可：
  * 想走官转 → `veo-3.1-fast-generate-preview` / `veo-3.1-generate-preview`
  * 想走官逆 → `veo-3.1-fast` / `veo-3.1-landscape` / `veo-3.1-fl` 等

<Tip>
  **推荐配法**：把"业务关键交付"打到官转，把"试错 / 批量预览 / 同步 UI"打到官逆，账号统一、账单清晰、能力互补。
</Tip>

## 相关文档

* [VEO 3.1 Official 概览](/api-capabilities/veo-3-1-official/overview) - 官转通道完整介绍
* [VEO 3.1（官逆）概览](/api-capabilities/veo/overview) - 既有官逆通道完整介绍
* [VEO 3.1 Official 文生视频 Playground](/api-capabilities/veo-3-1-official/text-to-video)
* [VEO 3.1 Official 图生视频 Playground](/api-capabilities/veo-3-1-official/image-to-video)
* [VEO 3.1（官逆）快速开始](/api-capabilities/veo/quick-start) - 同步流式调用示例
* [VEO 3.1（官逆）异步 API](/api-capabilities/veo/async-api) - 含首尾帧用法


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