Documentação da API Veo 3.1

Guia completo para integrar a geração de vídeos com IA do Google em suas aplicações.

Guia de início rápido

Comece a usar a API Veo 3.1 em apenas alguns minutos.

Obtenha sua chave da API

Primeiro, você precisará obter uma chave da API no seu painel.

Faça sua primeira requisição

curl -X POST "https://veo3api.com/generate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "a dog running",
    "model": "veo4",
    "duration": 5,
    "resolution": "720p"
  }'

Verificar status da geração

A geração de vídeo é assíncrona. https://veo3api.com/feed Use o endpoint para verificar o status ou forneça uma

cURL

curl -X GET "https://veo3api.com/feed?task_id=YOUR_TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

Referência da API

Referência completa de todos os endpoints, parâmetros e formatos de resposta da API Veo 3.1.

URL base

https://veo3api.com

Os endpoints não utilizam o prefixo /api — chame https://veo3api.com/ (por exemplo https://veo3api.com/generate).

Autenticação

Todas as requisições da API exigem autenticação usando um token Bearer no cabeçalho Authorization.

Authorization: Bearer YOUR_API_KEY

POSThttps://veo3api.com/generate

Gerar um vídeo a partir de um prompt de texto ou imagem

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`prompt`	string	*	O prompt de texto para geração de vídeo
`model`	string	*	Escolha veo3 (alta qualidade, 180 créditos), veo3-fast (geração rápida, 25 créditos) ou veo4 (preço por duração e resolução; veja a tabela abaixo)
`duration`	integer		Duração do Veo 4: 5, 10 ou 15 segundos (padrão: 5)
`resolution`	string		Resolução de saída do Veo 4: 480p, 720p (padrão) ou 1080p
`aspect_ratio`	string		Proporção: 16:9 (padrão, 1080P HD), 9:16 (retrato) ou Auto (corresponde à imagem)
`image_urls`	string[]		Array de URLs de imagens para geração de vídeo a partir de imagem
`watermark`	string		Texto de marca d’água personalizada. Defina como null para não usar marca d’água

Exemplo de requisição

JSON

{
  "prompt": "a dog running",
  "model": "veo4",
  "duration": 5,
  "resolution": "720p",
  "aspect_ratio": "16: 9"
}

Resposta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n90a1b2c3d4e5f6sd20",
    "status": "IN_PROGRESS",
    "consumed_credits": 240,
    "model": "veo4"
  }
}

Consumo de créditos

Tipo de modelo	Créditos	Custo
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`veo4`480p · 5s / 10s / 15s	160 / 320 / 480 credits	$1.60 / $3.20 / $4.80
`veo4`720p · 5s / 10s / 15s	240 / 480 / 720 credits	$2.40 / $4.80 / $7.20
`veo4`1080p · 5s / 10s / 15s	360 / 720 / 1080 credits	$3.60 / $7.20 / $10.80
`extend`	Igual ao original	-
`get-1080p`	Grátis	$0.00

O preço do Veo 4 depende da duração e da resolução; texto para vídeo e imagem para vídeo usam a mesma tarifa.

Nota: Os créditos são deduzidos apenas quando a geração do vídeo é concluída com sucesso. Tarefas com falha não consomem créditos.

GEThttps://veo3api.com/feed

Verificar o status de uma tarefa de geração de vídeo

Exemplo de requisição

GET https://veo3api.com/feed?task_id=YOUR_TASK_ID

Resposta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "request": {
      "prompt": "a dog running",
      "model": "veo4",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16: 9"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "consumed_credits": 240,
    "type": "text-to-video",
    "model": "veo4",
    "created_at": "2025-10-29 12: 20: 46"
  }
}

💡 Dica: A URL do vídeo gerado pode ser obtida no array data.response.

POSThttps://veo3api.com/extend

Estender um vídeo existente com um novo prompt. O vídeo estendido continuará a partir do ponto final do vídeo original.

Corpo da requisição

Parâmetro	Tipo	Obrigatório	Descrição
`task_id`	string	*	O task_id do vídeo original concluído a ser estendido
`prompt`	string	*	O prompt de texto descrevendo como continuar/estender o vídeo
`seeds`	integer		Semente aleatória (10000-99999) para geração reproduzível. A mesma semente produz resultados semelhantes
`watermark`	string		Texto de marca d’água personalizada. Defina como null para não usar marca d’água

Exemplo de requisição

JSON

{
  "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
  "prompt": "The dog continues running and jumps over a fence",
  "watermark": "veo"
}

Resposta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8b2c3dd60b80557bb4c678fddef53cdextd",
    "original_task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Nota: Este endpoint aceita apenas tarefas veo3 e veo3-fast concluídas. Ele não está disponível para tarefas Veo 4, e vídeos convertidos para 1080P também não podem ser estendidos.

GEThttps://veo3api.com/get-1080pGrátis

Obter a versão em alta definição 1080P de uma tarefa de vídeo concluída. Este endpoint é gratuito e não consome créditos.

Exemplo de requisição

GET https://veo3api.com/get-1080p?task_id=YOUR_TASK_ID

Resposta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo8a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Dica: Este endpoint aceita apenas tarefas veo3 e veo3-fast concluídas. Ele é gratuito e não consome créditos. O Veo 4 pode ser gerado diretamente em 1080p.

Códigos de status HTTP

Código de status	Descrição
`200`	Requisição bem-sucedida
`400`	Requisição inválida - Parâmetros incorretos
`401`	Não autorizado - Chave da API inválida
`429`	Limite de requisições excedido
`500`	Erro interno do servidor