VEO 3.1 视频生成

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

​

核心特性

​

模型定价

​

HD 系列（720p，已上线）

​

4K 高清系列（即将上线）

​

技术规格

​

端点一览

​

接入准备

​

令牌分组

​

在线测试工具：iCover AI

• 测试地址：icover.ai/zh/veo
• 接入方式：填入一个默认分组的令牌（按量优先 / 按次计费均可），即可直接体验文生视频与首尾帧创作
• 工具背景：iCover AI 是 API易（APIYI）官方运营的 AI 视频生成测试工具，与生产 API 共用同一套服务，测试效果即代表正式调用效果

​

关键参数详解

​

模型变体命名规则

• veo-3.1 —— 标准竖屏文生视频（默认）
• veo-3.1-landscape-fast —— 快速横屏文生视频（性价比首选）
• veo-3.1-landscape-fl —— 标准横屏首尾帧创作
• veo-3.1-landscape-fast-fl —— 快速横屏首尾帧创作（成本最低的图生视频）

​

n（一次出几条视频，同步模式）

• 范围：1 ~ 4，默认 1
• 仅同步模式（/v1/chat/completions）支持，异步模式 n 不生效
• 按视频条数计费（n=2 即按 2 条结算）

​

最佳实践

​

错误码与重试

​

内容审核错误（PUBLIC_ 前缀）

1. 重写 prompt：去除人名、品牌、敏感词；如有对白，改为通用描述（例如「角色用平静语气说话」）
2. 替换参考图：避免使用真实人物（特别是名人）作为首尾帧
3. 重试不计费：该类任务平台不扣额度，可放心调整后重试

{
  "task_id": "video_693742f8-45c9-4608-85e0-1c4b3dea97eb",
  "object": "task",
  "task_type": "sora2_video_generation",
  "model_name": "veo-3.1-fl",
  "platform": "openai",
  "status": "failed",
  "progress": "100%",
  "fail_reason": "PUBLIC_ERROR_AUDIO_FILTERED",
  "error": {
    "message": "PUBLIC_ERROR_AUDIO_FILTERED",
    "type": "task_failed"
  },
  "data": {
    "id": "video_693742f8-45c9-4608-85e0-1c4b3dea97eb",
    "object": "video",
    "model": "veo-3.1-fl",
    "size": "720x1280",
    "status": "failed",
    "error": {
      "code": "",
      "message": "PUBLIC_ERROR_AUDIO_FILTERED"
    }
  }
}

​

常见问题

data: {"choices":[{"delta":{"content":"> 🏃 进度：45.0%\n\n"}}]}
...
data: {"choices":[{"delta":{"content":"> ✅ 第1个视频生成成功，[点击这里](https://.../xxx.mp4) 查看视频~~~\n\n"}}]}
data: [DONE]

from openai import OpenAI
client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
resp = client.chat.completions.create(
    model="veo-3.1-fast",
    messages=[{"role": "user", "content": "画只猫在天上飞"}],
    stream=True,
    n=1
)
for chunk in resp:
    print(chunk.choices[0].delta.content or "", end="")

​

相关文档

• 同步调用 API - /v1/chat/completions + stream: true 实时流式调用，文生视频 + 首尾帧示例
• 异步调用 API - /v1/videos 三步异步流程、首尾帧上传、Python 完整客户端示例
• Sora 2 视频生成 - OpenAI 官转通道对照
• 充值加赠活动 - 加赠最高档位与适用渠道
• API 使用手册 - 通用调用规范、超时与重试建议
• 谷歌官方 Veo 介绍：deepmind.google/technologies/veo/