Geração de Vídeos Veo
Gere vídeos com IA através da API Google Veo da AceDataCloud.
Configuração: Veja autenticação para configurar o token.
Início Rápido
curl -X POST https://api.acedata.cloud/veo/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "text2video", "prompt": "uma baleia saindo da água em câmera lenta na hora dourada", "model": "veo3", "callback_url": "https://api.acedata.cloud/health"}'
Assíncrono: Veja polling de tarefas assíncronas. Consulte via
POST /veo/taskscom{"id": "..."}. Isso retorna um ID de tarefa imediatamente. Consulte o resultado:
curl -X POST https://api.acedata.cloud/veo/tasks \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"id": "<task_id obtido acima>"}'
Modelos
| Modelo | Áudio | Melhor Para |
|---|---|---|
veo2 | Não | Geração econômica |
veo2-fast | Não | Geração rápida e econômica (padrão) |
veo3 | Sim (nativo) | Geração audiovisual completa |
veo3-fast | Sim (nativo) | Geração audiovisual mais rápida |
veo31 | Sim (nativo) | Veo 3.1, maior qualidade |
veo31-fast | Sim (nativo) | Variante rápida do Veo 3.1 |
veo31-fast-ingredients | Sim (nativo) | Veo 3.1 rápido, modo ingrediente |
Fluxos de Trabalho
1. Texto para Vídeo
POST /veo/videos
{
"action": "text2video",
"prompt": "tomada aérea cinematográfica da Aurora Boreal sobre a Islândia",
"model": "veo3",
"resolution": "1080p"
}
2. Imagem para Vídeo
Anime imagens estáticas em vídeo.
POST /veo/videos
{
"action": "image2video",
"prompt": "a cena ganha vida suavemente com vento e movimento sutil",
"image_urls": ["https://exemplo.com/paisagem.jpg"],
"model": "veo2",
"aspect_ratio": "16:9"
}
3. Ingredientes para Vídeo (Mixagem de Múltiplas Imagens)
Misture de 1 a 3 imagens de referência em um vídeo (apenas veo31-fast-ingredients).
POST /veo/videos
{
"action": "ingredients2video",
"image_urls": [
"https://exemplo.com/img1.jpg",
"https://exemplo.com/img2.jpg"
],
"model": "veo31-fast-ingredients"
}
4. Upscale para 1080p
Converta um vídeo gerado anteriormente para resolução full 1080p.
POST /veo/videos
{
"action": "get1080p",
"video_id": "seu-id-do-video",
"model": "veo3"
}
Parâmetros
| Parâmetro | Valores | Descrição |
|---|---|---|
action | "text2video", "image2video", "ingredients2video", "get1080p" | Modo de geração |
model | veja tabela Modelos | Modelo a usar (padrão: veo2-fast) |
resolution | "4k", "1080p", "gif" | Resolução de saída (padrão: 720p) |
aspect_ratio | "16:9", "9:16", "1:1", "4:3", "3:4" | Proporção de tela — válido apenas para image2video |
image_urls | array de strings | URLs de imagem de referência — para image2video (até 2) ou ingredients2video (até 3) |
video_id | string | Vídeo a ser ampliado — apenas para get1080p |
translation | true / false | Traduzir automaticamente o prompt para inglês (padrão: false) |
Endpoints Pós-Geração
Após gerar um vídeo, use estes endpoints para processá-lo ainda mais:
Upsample (POST /veo/upsample)
Aumente a resolução de um vídeo gerado para 1080p, 4K ou converta para GIF.
POST /veo/upsample
{
"video_id": "seu-id-do-video",
"action": "4k"
}
| Parâmetro | Valores | Descrição |
|---|---|---|
video_id | string | ID da tarefa de /veo/videos, /veo/extend, /veo/reshoot ou /veo/objects |
action | "1080p", "4k", "gif" | Alvo do upsampling |
Estender (POST /veo/extend)
Continue um vídeo existente — a IA gera automaticamente o próximo segmento.
POST /veo/extend
{
"video_id": "seu-id-do-video",
"model": "veo31-fast",
"prompt": "a câmera lentamente dá zoom out"
}
| Parâmetro | Valores | Descrição |
|---|---|---|
video_id | string | ID da tarefa de /veo/videos ou de um /veo/extend anterior |
model | "veo31-fast", "veo31" | Apenas a série Veo 3.1 é suportada |
prompt | string | Opcional: guia o segmento estendido |
Reenquadrar (POST /veo/reshoot)
Renderize novamente um vídeo mantendo o mesmo conteúdo, mas aplicando um novo movimento de câmera.
POST /veo/reshoot
{
"video_id": "seu-id-do-video",
"motion_type": "LEFT_TO_RIGHT"
}
| Parâmetro | Valores | Descrição |
|---|---|---|
video_id | string | ID da tarefa de /veo/videos (não pode usar saída de /veo/extend) |
motion_type | veja tabela abaixo | Movimento de câmera a aplicar |
Valores de motion_type:
STATIONARY, STATIONARY_UP, STATIONARY_DOWN, STATIONARY_LEFT, STATIONARY_RIGHT, STATIONARY_DOLLY_IN_ZOOM_OUT, STATIONARY_DOLLY_OUT_ZOOM_IN, UP, DOWN, LEFT_TO_RIGHT, RIGHT_TO_LEFT, FORWARD, BACKWARD, DOLLY_IN_ZOOM_OUT, DOLLY_OUT_ZOOM_IN
Objetos (POST /veo/objects)
Insira ou remova objetos em um vídeo usando inpainting baseado em máscara.
POST /veo/objects
{
"video_id": "seu-id-do-video",
"action": "insert",
"prompt": "adicione um pássaro voando"
}
POST /veo/objects
{
"video_id": "seu-id-do-video",
"action": "remove",
"image_mask": "https://exemplo.com/mascara.jpg"
}
| Parâmetro | Valores | Descrição |
|---|---|---|
video_id | string | ID da tarefa (não pode usar saída de /veo/extend) |
action | "insert", "remove" | Tipo de operação |
prompt | string | Obrigatório para insert; opcional para remove |
image_mask | string | URL ou JPEG em base64 — pixels brancos = região alvo. Obrigatório para remove; opcional para insert |
Armadilhas
- Os modelos Veo 3 e 3.1 geram áudio nativo —
veo2/veo2-fastNÃO suportam áudio - A ação
get1080pusavideo_id(de uma geração anterior), não uma URL aspect_ratioé válido apenas para a açãoimage2videoimage_urlsaceita um array — até 2 imagens paraimage2video, até 3 paraingredients2videoveo31-fast-ingredientsrequer entrada de imagem — não pode fazer geração apenas com textotranslation: truetraduz automaticamente prompts em chinês ou outros idiomas antes de enviar ao Veo- O polling de tarefas usa
id(nãotask_id) no corpo da requisição/veo/tasks - Os estados das tarefas usam
"succeeded"(não "completed") — verifique este valor ao fazer polling - A saída de
/veo/extendnão pode ser usada como entrada para/veo/reshootou/veo/objects
MCP:
pip install mcp-veo| Hospedado:https://veo.mcp.acedata.cloud/mcp| Veja todos os servidores MCP