跳转到主要内容

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
模型 IDveo-3.1-generate-preview / veo-3.1-fast-generate-previewveo-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 系列)
分组DefaultDefault
计费模式按次计费 ✅ / 按量优先 ✅(按量计费 ❌)按次计费 ✅ / 按量优先 ✅
响应字段id / task_id / status / progress(粗粒度 0/50/100)同步:完整 chat completion;异步:task_id / status
失败计费❌ 不计费❌ 不计费
音频原生同步音轨原生同步音轨
适用场景追求官方质量稳定、能接受异步轮询的生产场景预算敏感、需要同步流式 UI 进度、需要首尾帧创作

三步决策树

1

Q1: 你需要首尾帧(Frame-to-Video)能力吗?

  • 需要 → 走 官逆 VEO 3.1-fl 系列(如 veo-3.1-landscape-fast-fl),官转暂未开放首尾帧
  • 不需要 → 进入 Q2
2

Q2: 你的前端需要同步流式进度条吗?

  • 需要(用户等待 UI 不能空白) → 走 官逆 VEO 3.1/v1/chat/completions 同步流式端点
  • 后端任务化(队列消费、批量出片) → 进入 Q3
3

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-preview4–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
推荐配法:把”业务关键交付”打到官转,把”试错 / 批量预览 / 同步 UI”打到官逆,账号统一、账单清晰、能力互补。

相关文档