API do Veo 3.1 — texto para vídeo do Google com áudio nativo, compatível com OpenAI (2026)

O Veo 3 é o modelo de texto para vídeo do Google, e a API do Veo 3 gera clipes cinematográficos — com áudio nativo e sincronizado — a partir de um prompt de texto ou de uma imagem estática. O Kunavo oferece toda a família (veo-3-lite, veo-3 Fast e veo-3-quality) pelo endpoint de vídeo no estilo da OpenAI, a cerca de 50–70% abaixo do preço de tabela do Google, usando um único token bearer.

Chame a API do Veo 3

Gere uma chave em /app/keys e faça POST para /v1/video/generations. A geração leva alguns minutos, portanto a chamada síncrona mantém a conexão até o clipe ficar pronto:

import requests

resp = requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",                 # Fast tier; also veo-3-lite / veo-3-quality
        "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
        "aspect_ratio": "16:9",
        "resolution": "720p",
    },
    timeout=600,  # Veo 3 generation takes minutes
)
print(resp.json()["data"][0]["url"])

A mesma chamada com curl:

curl https://api.kunavo.com/v1/video/generations \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 600 \
  -d '{
    "model": "veo-3",
    "prompt": "aerial push-in over a misty pine valley at dawn, birds, soft light",
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

E se o restante do seu código já usa o SDK da OpenAI, você pode manter um único cliente para tudo — chat, imagens e vídeo compartilham a chave e o base_url:

# Already using the OpenAI SDK? Keep it — only base_url changes.
# Video isn't in the OpenAI SDK surface, so reuse its client for auth/config
# and post to the video route directly.
import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",
)

resp = client.post(
    "/video/generations",
    body={"model": "veo-3", "prompt": "a neon-lit alley in the rain"},
    cast_to=object,
    options={"timeout": 600.0},
)
print(resp["data"][0]["url"])

duration (em segundos) define a duração do clipe nos modelos cobrados por segundo: os modelos Seedance e o Wan 2.7. Os modelos Veo ignoram esse valor; cada clipe do Veo tem 8 segundos e é cobrado por vídeo.

As URLs retornadas são permanentes. Os parâmetros completos (resolution, aspect_ratio, image_urls, image_mode) estão na referência da API de vídeo.

No Kunavo, o Veo não tem parâmetro de seed nem de prompt negativo. Se uma solicitação enviar algum deles, esse parâmetro será ignorado.

Níveis e preços

O Veo 3 tem três níveis de qualidade. As tarifas por vídeo abaixo são para um clipe de 8 segundos em 720p; 1080p e 4K custam mais. As tarifas atuais estão na página de cada modelo.

Imagem para vídeo

Passe image_url para animar uma imagem estática — útil para manter um produto ou personagem consistente. Passe um primeiro e um último quadro para transições controladas.

# Image-to-video: animate a still by passing image_url
requests.post(
    "https://api.kunavo.com/v1/video/generations",
    headers={"Authorization": f"Bearer {API_KEY}"},
    json={
        "model": "veo-3",
        "prompt": "slow parallax, gentle wind through the grass",
        "image_url": "https://your-cdn.com/keyframe.png",
    },
    timeout=600,
)

Assíncrono em produção

Não mantenha uma conexão de vários minutos em escala. Envie uma tarefa para /v1/videos, obtenha um ID de tarefa e consulte GET /v1/videos/{id} até a conclusão — com chaves de idempotência e webhooks opcionais. O ciclo completo está na documentação de vídeo.

Como criar prompts para o Veo 3

• Descreva a cena, não apenas o assunto — movimento de câmera (travelling, panorâmica, aproximação), sensação da lente, iluminação e ritmo são o que mais importa.
• Aproveite o áudio — o Veo 3 renderiza som, então mencione a ambiência ou os efeitos desejados.
• Defina explicitamente a proporção de tela — 16:9 para paisagem, 9:16 para vertical/social.
• Cada clipe do Veo tem 8 segundos — planeje cada cena para essa duração e una várias gerações para sequências mais longas.

Kunavo vs. chamar o Google diretamente

O Veo 3 também está disponível diretamente pela Gemini API e pelo Vertex AI. Essa opção é a certa se você precisa do SLA e do contrato de suporte do próprio Google. A comparação honesta é:

Versão curta: a Kunavo ganha em tempo de configuração, preço unitário e por ter uma chave para todas as modalidades. O Google direto ganha quando você precisa de uma garantia de cota ou de um acordo empresarial.

Veo 3 vs. Sora e Kling

O Veo 3 é o modelo de texto para vídeo geralmente disponível mais forte atualmente e o único ativo na Kunavo. Sora e Kling estão no roadmap atrás do mesmo endpoint — consulte o guia da API de texto para vídeo para conhecer o panorama dos modelos, e os guias da API do Sora e da API do Kling para essas famílias.

Está escolhendo entre os modelos de vídeo pelo preço, e não apenas dentro desta família? A comparação de APIs de geração de vídeo calcula o preço dos oito para o mesmo clipe de 8 segundos em 720p.

Perguntas frequentes