Veo 3.1 视频生成 API

通过统一异步接口调用 Google 官方模型 ID。官方和 Ext 渠道使用相同的提交、查询及下载流程，供应商型号由服务端映射。

• veo-3.1-generate-preview — Veo 3.1
• veo-3.1-fast-generate-preview — Veo 3.1 Fast

参数与渠道能力

默认 8 秒、720p、16:9，并生成音频。官方渠道支持 4、6、8 秒；Ext 仅支持 8 秒。1080p 和 4K 均须使用 8 秒。每个任务只生成一个视频。

官方渠道支持 generate_audio:false、negative_prompt、seed（包括 0）、person_generation、resize_mode 和 enhance_prompt:true。Ext 不支持关闭音频；这些官方专属参数会尝试路由到官方渠道。不要传入供应商内部型号。

image_urls 可传首帧、首尾两帧；Fast 的 Ext 渠道还支持三张参考图（generation_type:reference，仅 16:9）。Standard 不支持三图参考模式。图片须为公开可访问的 HTTP(S) URL。

{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise, natural ambient sound","duration":8,"resolution":"720p","aspect_ratio":"16:9","generate_audio":true}

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"A paper boat drifting across a quiet lake at sunrise","duration":8,"resolution":"720p","generate_audio":true}'

POST https://apimaster.ai/v1/videos → {"id":"task_...","task_id":"task_...","status":"queued"}

提交返回 id 只表示已受理。每 5–10 秒查询一次，等待 completed；failed 表示生成失败。完成后携带同一个 API Key 下载视频并及时保存。

curl "https://apimaster.ai/v1/videos/task_..." -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_.../content" -H "Authorization: Bearer YOUR_API_KEY" -o video.mp4

queued → in_progress → completed / failed

计费与退款

下表为 Google 官方基础价（USD/秒），不是统一成交价。实际扣费结合渠道系数和账号价格规则；以后台模型卡和消费日志为准。Ext 每次按 8 秒计价；续写也按一次新的 8 秒计价单位收费，不按包含原视频的总长度重复计费。失败任务由异步任务账务退回生成预扣款。

Google model	720p + audio	1080p + audio	4K + audio	720p silent	1080p silent	4K silent
veo-3.1-generate-preview	$0.40/s	$0.40/s	$0.60/s	$0.20/s	$0.20/s	$0.40/s
veo-3.1-fast-generate-preview	$0.10/s	$0.12/s	$0.30/s	$0.08/s	$0.10/s	$0.25/s

Google Gemini API · Google Cloud

视频续写

2026-10-17 验收：续写已在 Standard Ext（veo-3.1-generate-preview）通过。Fast 续写当前被上游拒绝；需要续写时，请先使用标准版生成原视频。

仅支持已完成的 Ext 任务，且使用相同模型、原账号与原渠道。官方任务不支持此续写接口。raw:true 仅请求续写部分。无效参数返回 400；固定不支持该规格的渠道时返回 503，可选择兼容渠道后重试。

curl "https://apimaster.ai/v1/videos/task_.../remix" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"veo-3.1-generate-preview","prompt":"The paper boat continues past green reeds","raw":false,"resolution":"720p","aspect_ratio":"16:9"}'