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": "veo3-fast",
    "watermark": "veo"
  }'

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 entre veo3 (alta qualidade, 180 créditos) ou veo3-fast (geração rápida, 25 créditos)
`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": "veo3-fast",
  "watermark": "veo"
}

Resposta

JSON Response 200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv"
  }
}

Consumo de créditos

Tipo de modelo	Créditos	Custo
`veo3-fast`	25 credits	$0.25
`veo3`	180 credits	$1.80
`extend`	Igual ao original	-
`get-1080p`	Grátis	$0.00

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": "veo3-fast",
      "watermark": "veo"
    },
    "response": [
      "https://cdn.veo3api.com/video/example_watermarked.mp4"
    ],
    "status": "COMPLETED",
    "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
  "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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "credits_consumed": 25
  }
}

Nota: Apenas tarefas de vídeo concluídas podem ser estendidas. Vídeos convertidos para 1080P 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": "veo4a7f5dd50a90446aa3c567ecceea42bcbksv",
    "result_url": "https://cdn.veo3api.com/video/example_1080p.mp4"
  }
}

💡 Dica: Este endpoint é totalmente gratuito. Você pode obter a versão 1080P de qualquer vídeo concluído sem consumir créditos.

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