API de vídeo Veo 3.1

Use os IDs oficiais do Google numa API assíncrona comum. Os modelos internos Official e Ext são mapeados no servidor.

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

Parâmetros e rotas

Padrão: 8 segundos, 720p, 16:9 e áudio ativado. Official aceita 4, 6 ou 8 segundos; Ext apenas 8. 1080p e 4K exigem 8 segundos. Um vídeo por tarefa.

Official aceita generate_audio:false, negative_prompt, seed (incluindo 0), person_generation, resize_mode e enhance_prompt:true. Ext não desativa áudio. Parâmetros exclusivos podem usar uma rota oficial disponível. Não use IDs internos do fornecedor.

image_urls aceita o primeiro quadro ou o primeiro e o último. Fast Ext também aceita três referências (generation_type:reference, apenas 16:9). Standard não aceita esse modo. Use URLs HTTP(S) públicas.

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

Um id confirma apenas o recebimento. Consulte a cada 5–10 segundos até completed ou failed e faça o download com a mesma chave API.

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

Preço e reembolso

A tabela mostra preços oficiais base do Google em USD/segundo. O valor final depende da rota e das regras da conta; consulte os cartões e registros. Ext cobra 8 segundos por chamada, inclusive extensão, sem cobrar novamente o vídeo original. Tarefas com falha devolvem a reserva de geração.

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

Estender vídeo

Verificado em 2026-10-17: a extensão funciona no Standard Ext (veo-3.1-generate-preview). O fornecedor rejeita atualmente extensões Fast. Gere o vídeo original com Standard se pretender estendê-lo.

Somente tarefas Ext concluídas, com o mesmo modelo, proprietário e rota original. Official não aceita este endpoint. raw:true retorna apenas a extensão. Parâmetros inválidos: 400; rota fixa incompatível: 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"}'