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"}'