Vídeo
Veo 3.1 Lite Official video
Veo 3.1 Lite Official. Texto, imagem e primeiro/ultimo quadro em 4s, 6s ou 8s; 1080p e primeiro/ultimo quadro exigem 8s.
Categoria: Criação · veo-3-1-lite-official
Quando escolher
A entrada economica oficial do Veo: texto, imagem ou primeiro/ultimo quadro, com audio opcional.
Bom para:
- testar uma ideia em 720p com custo baixo
- animar uma imagem de partida
- transicao por primeiro e ultimo quadro em 8 segundos
Evite:
- modo de tres referencias
- 1080p em 4 ou 6 segundos
- primeiro e ultimo quadro fora de 8 segundos
E mais barato, mas sem modo de tres referencias. Em 1080p e em primeiro/ultimo quadro, a duracao e obrigatoriamente 8 segundos.
Alternativas:
veo-3-1-fast-official— Fast Official quando precisar de tres referencias ou mais flexibilidade.veo-3-1-lite— Lite normal permanece para fluxos legados de texto puro em 8 segundos.
Como usar & limites
- A opção econômica da família para texto→vídeo, imagem→vídeo e primeiro/último quadro.
- prompt e duration são obrigatórios; duration aceita somente 4, 6 ou 8 segundos.
- Aceita no máximo 2 imagens. Duas imagens representam primeiro e último quadro e exigem duration: 8.
- 1080p também exige duration: 8. Não há modo de três referências nem resolução 4k.
- aspect_ratio aceita 16:9, 9:16 ou auto; auto requer uma ou duas imagens.
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 | — |
allowed_durations Durações permitidas | 4, 6, 8 |
reference_to_video Referência → vídeo | — |
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 | — | — | — – 2 | Opcional: até 2 imagens. Duas representam primeiro e último quadro e exigem 8 segundos. |
duration | Duration | select | Obrigatório | 8 | — | — | 4, 6 ou 8 segundos. Primeiro/último quadro e 1080p exigem 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 | — | 720p ou 1080p; 1080p exige 8 segundos. |
sound | Generate native audio | boolean | Opcional | true | — | — | Ativa o áudio nativo do vídeo. Padrão: ativado. |
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-lite-official",
"prompt": "Produto de skincare sobre pedra clara, câmera faz um push-in lento, luz natural de manhã e textura de água ao fundo.",
"params": {
"duration": 8,
"aspect_ratio": "9:16",
"resolution": "720p",
"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-lite-official",
"prompt": "Produto de skincare sobre pedra clara, câmera faz um push-in lento, luz natural de manhã e textura de água ao fundo.",
"params": {
"duration": 8,
"aspect_ratio": "9:16",
"resolution": "720p",
"sound": true
}
}),
});
const { data } = await res.json();
Exemplo de resposta
{
"id": "9f0c1a7e-…",
"object": "generation",
"model": "veo-3-1-lite-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. |