Vídeo
Veo 3.1 Fast Official video
Veo 3.1 Fast Official. Texto, imagem, primeiro/ultimo quadro e tres referencias. 4s, 6s ou 8s com audio nativo opcional.
Categoria: Criação · veo-3-1-fast-official
Quando escolher
Veo oficial para iterar com texto, imagem, quadros ou referencias em 4, 6 ou 8 segundos.
Bom para:
- iterar uma cena com audio nativo opcional
- animar uma imagem ou dirigir uma transicao por primeiro e ultimo quadro
- usar ate tres imagens para fixar referencias em um clipe de 8 segundos
Evite:
- referencias de tres imagens em 4 ou 6 segundos
- acabamento maximo quando o Quality Official cabe no orcamento
A linha Official traz duracoes de 4, 6 e 8 segundos e audio opcional. Use Fast para validar direcao; o preco varia por resolucao e audio.
Alternativas:
veo-3-1-quality-official— Quality Official para o take final com mais investimento.veo-3-1-lite-official— Lite Official para a opcao mais economica da linha.
Como usar & limites
- Gera vídeo a partir de texto, uma imagem, primeiro e último quadro ou até três referências.
- prompt e duration são obrigatórios; duration aceita somente 4, 6 ou 8 segundos.
- Com 1 imagem, use imagem→vídeo. Com 2 imagens, use generation_type: frame para primeiro e último quadro. Com 3 imagens, use generation_type: reference e duration: 8.
- aspect_ratio aceita 16:9, 9:16 ou auto. O modo auto requer uma ou duas imagens; não o use em texto puro nem com três referências.
- resolution aceita 720p, 1080p ou 4k. sound habilita ou desabilita o áudio nativo.
Capacidades
O que este modelo suporta, direto do schema — sem preços, sem detalhes de infraestrutura.
| Capacidade | Valor |
|---|---|
frame_mode Modo de frame | Sim |
video_edit Edição de vídeo | — |
native_audio Áudio nativo | Sim |
featuredModes FeaturedModes | |
text_to_video Texto → vídeo | Sim |
image_to_video Imagem → vídeo | Sim |
reference_mode Modo de referência | Sim |
allowed_durations Durações permitidas | 4, 6, 8 |
reference_to_video Referência → vídeo | Sim |
Parâmetros
Campos aceitos em params (ou de primeira classe, quando aplicável) para POST /generations.
| Nome | Rótulo | Tipo | Obrigatório | Padrão | Opções | Mín / Máx | Descrição |
|---|---|---|---|---|---|---|---|
prompt | Prompt | textarea | Obrigatório | — | — | — | Direção da cena. Obrigatório. |
image_urls | Image references | multi_select | Opcional | — | — | — – 3 | Opcional: até 3 imagens. Duas são primeiro/último quadro; três exigem o modo reference e 8 segundos. |
aspect_ratio | Aspect ratio | select | Opcional | 16:9 | 16:9 · 9:16 · auto | — | 16:9, 9:16 ou auto. auto requer uma ou duas imagens. |
resolution | Resolution | select | Opcional | 720p | 720p · 1080p · 4k | — | 720p, 1080p ou 4k. |
sound | Generate native audio | boolean | Opcional | true | — | — | Ativa o áudio nativo do vídeo. Padrão: ativado. |
duration | Duration | select | Obrigatório | 8 | — | — | 4, 6 ou 8 segundos. Três referências exigem 8 segundos. |
generation_type | Generation mode | select | Opcional | — | frame · reference | — | frame para primeiro/último quadro; reference para exatamente 3 referências. Opcional quando o modo puder ser inferido. |
Exemplo de requisição
curl -X POST https://caranguejo.art/api/v1/dev/generations \
-H "Authorization: Bearer $CK" \
-H "Content-Type: application/json" \
-d '{
"model": "veo-3-1-fast-official",
"prompt": "Uma câmera acompanha uma bicicleta vermelha atravessando uma rua molhada ao amanhecer, reflexos suaves e som ambiente urbano.",
"params": {
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}'
const res = await fetch("https://caranguejo.art/api/v1/dev/generations", {
method: "POST",
headers: {
"Authorization": "Bearer " + process.env.CK,
"Content-Type": "application/json",
},
body: JSON.stringify({
"model": "veo-3-1-fast-official",
"prompt": "Uma câmera acompanha uma bicicleta vermelha atravessando uma rua molhada ao amanhecer, reflexos suaves e som ambiente urbano.",
"params": {
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "1080p",
"sound": true
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "veo-3-1-fast-official",
"type": "video",
"status": "completed",
"output": {
"assets": [
{
"url": "https://media.caranguejo.art/outputs/example.mp4",
"type": "video"
}
]
}
}
O custo real do job é retornado em credits_charged na resposta concluída — consulte GET /balance para o saldo da conta.
Erros comuns deste tipo de job:
insufficient_credits | Saldo insuficiente para cobrir o job. |
content_policy_violation | Prompt ou mídia recusados por política de conteúdo. |
generation_timeout | O job excedeu o tempo máximo de processamento. |
rate_limited | Limite de requisições por minuto excedido. |
invalid_input | Parâmetro obrigatório ausente ou fora do schema do modelo. |
generation_failed | Falha genérica no processamento do job. |