Veo 3.1 API 已下线怎么办:改用 Gemini Omni Flash 生成视频(模型名、价格、迁移要点与限制,2026)
一句话结论
Gemini API 里的 Veo 3.1 预览版已经在 2026-10-22 下线,继续调用会失败。官方推荐的替代是 Gemini Omni Flash(模型名 gemini-omni-1.1-flash),或者改用 Gemini Enterprise Agent Platform 上正式发布的 Veo 模型。注意 Omni Flash 走的是 Interactions API,和 Veo 原来的长时间运行任务接口不一样,不能只改模型名,调用代码要重写。
阅读说明
官方信息查阅日期:2026-10-24,来源:Google AI for Developers 的 Deprecations、Video generation、Gemini Omni Flash 和 Pricing 页面。价格以官网为准,可能随地区和税费变化。
下线时间表(Gemini API)
| 模型 | 下线日期 | 官方推荐替代 |
|---|---|---|
veo-3.1-generate-preview | 2026-10-22 | gemini-omni-1.1-flash |
veo-3.1-fast-generate-preview | 2026-10-22 | gemini-omni-1.1-flash |
veo-3.1-lite-generate-preview | 2026-10-22 | gemini-omni-1.1-flash |
gemini-omni-flash-preview | 2026-10-22 | gemini-omni-1.1-flash |
veo-3.0-generate-001、veo-3.0-fast-generate-001、veo-2.0-generate-001 | 2026-06-30 | gemini-omni-1.1-flash 或 Gemini Enterprise Agent Platform 上的正式版模型 |
gemini-omni-1.1-flash 于 2026-08-27 发布,官方目前未公布下线日期。
Gemini Omni Flash 能做什么
- 文生视频:根据文字生成带音频的视频,默认横屏 16:9,可设
aspect_ratio为9:16竖屏; - 图生视频:给一张参考图加提示词,模型自行决定怎么用这张图;也可以指定首帧、尾帧,首尾同一张图可以做循环视频;
- 对话式编辑:用
previous_interaction_id接着上一轮说「把灯光改得更戏剧化」「给这个人戴顶帽子」,模型只改你提到的部分; - 编辑自己上传的视频:通过 Files API 上传后修改;
- 延长视频:在片尾追加 3–10 秒的续写;
- 参考图 / 参考视频:保持角色或风格一致。
分辨率与价格
| 输出分辨率 | 说明 |
|---|---|
| 360p | |
| 720p | 默认 |
| 1080p | 放大(upscaled) |
| 4K | 放大(upscaled) |
按官方定价页(查阅日期:2026-10-24),gemini-omni-1.1-flash 只在付费层可用,免费层不提供:
| 项目 | 付费层价格(每 100 万 token,美元) |
|---|---|
| 输入(文本 / 图片 / 视频 / 音频) | 1.50 |
| 输出:文本(含思考 token) | 9.00 |
| 输出:视频 | 17.50 |
官方说明视频按输出 token 计费,720p 视频每秒约 5,792 token,标准价下折合约每秒 0.10 美元。付费层的数据不用于改进 Google 产品。
迁移要点
- 换接口:Veo 预览版用的是生成视频的长时间运行任务;Omni Flash 用
client.interactions.create(model="gemini-omni-1.1-flash", input="..."),返回结果里取视频数据; - 取结果方式:SDK 里有
interaction.output_video便捷字段;直接调 REST 时要从返回的steps数组里找model_output中的视频; - 大文件:视频大于 4 MB 时,官方建议在
response_format里设delivery="uri",避免超出返回大小限制; - 不支持的参数:系统指令、
temperature、top_p、停止序列和负面提示词都不支持,不想要的内容直接写在提示词里(如「不要出现文字」); - 想继续用 Veo:改用 Gemini Enterprise Agent Platform 上的正式版 Veo 模型。
官方列出的限制
- 欧洲经济区、瑞士、英国:不能编辑或延长上传的视频(编辑或延长模型自己生成的视频可以),不能上传和编辑含未成年人的图片;
- 不能上传和编辑含某些可识别人物的图片;
- 上传用于编辑或延长的视频需在 10 秒以内;延长只能往片尾加,不能往前或中间插;
- 不支持修改人声,暂不支持上传音频作为参考;
- 参考视频最多 3 段、每段最多 3 秒,参考视频里的音频会被忽略;不支持跨多个视频推理;
- 不支持 YouTube 视频作为素材,不支持预配吞吐量;
- 所有生成的视频都带 SynthID 隐形水印,可以用程序检测来源。
常见问题
调用 veo-3.1-generate-preview 报模型不存在?
它已经下线了,按上面的迁移要点改用 gemini-omni-1.1-flash。其他 Gemini API 报错见 Gemini API 403 和 Gemini API 429。
免费 API Key 能用吗?
不能,Omni Flash 只在付费层提供。Gemini API 免费层能用哪些模型见 Gemini API 免费额度与价格。
不写代码,想在 App 里生成视频?
Gemini App 和 Google AI 套餐的区别见 Google AI Plus、Pro、Ultra 套餐区别;其他 AI 视频工具见 AI 视频专题。
参考来源(官方)
- Google AI for Developers · Deprecations:https://ai.google.dev/gemini-api/docs/deprecations(查阅日期:2026-10-24)
- Google AI for Developers · Video generation in the Gemini API:https://ai.google.dev/gemini-api/docs/video(查阅日期:2026-10-24)
- Google AI for Developers · Generate and edit videos with Gemini Omni Flash:https://ai.google.dev/gemini-api/docs/omni(查阅日期:2026-10-24)
- Google AI for Developers · Gemini Developer API pricing:https://ai.google.dev/gemini-api/docs/pricing(查阅日期:2026-10-24)