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.
API易 同时提供两条 Veo 3.1 通道。本页帮你按场景选型:追求官方画质稳定性、能接受异步轮询 → 走 官转(本系列);预算敏感、需要同步流式或首尾帧 → 走 官逆(VEO 3.1)。两条通道可以同账号并行使用,不冲突。
全维度对照表
| 维度 | 官转(本系列) | 官逆(既有 VEO 3.1) |
|---|---|---|
| 通道类型 | 透传 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 进度、需要首尾帧创作 |
三步决策树
Q1: 你需要首尾帧(Frame-to-Video)能力吗?
- 需要 → 走 官逆 VEO 3.1 的
-fl系列(如veo-3.1-landscape-fast-fl),官转暂未开放首尾帧 - 不需要 → 进入 Q2
Q2: 你的前端需要同步流式进度条吗?
- 需要(用户等待 UI 不能空白) → 走 官逆 VEO 3.1 的
/v1/chat/completions同步流式端点 - 后端任务化(队列消费、批量出片) → 进入 Q3
Q3: 你的预算 vs 画质优先级如何?
- 预算优先($0.15 vs $0.3 差距明显)→ 走 官逆 VEO 3.1,单价低 50%
- 画质 / 稳定性优先(最终交付、4K 高清、强指令遵循) → 走 官转(本系列)的
veo-3.1-generate-preview - 试水预览 → 走 官转的
veo-3.1-fast-generate-preview($0.3)或 官逆的-fast($0.15)
典型场景配对建议
| 业务场景 | 推荐通道 | 推荐模型 | 理由 |
|---|---|---|---|
| 短视频矩阵批量生产(每天 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等
- 想走官转 →
相关文档
- VEO 3.1 Official 概览 - 官转通道完整介绍
- VEO 3.1(官逆)概览 - 既有官逆通道完整介绍
- VEO 3.1 Official 文生视频 Playground
- VEO 3.1 Official 图生视频 Playground
- VEO 3.1(官逆)快速开始 - 同步流式调用示例
- VEO 3.1(官逆)异步 API - 含首尾帧用法