O acesso à API Veo parece simples se você apenas lê o nome do modelo. Em produção, ele é um fluxo de trabalho de vídeo com verificações do ciclo de vida do modelo, preços por segundo, operações assíncronas, escolhas de resolução, custos de retry e observabilidade no nível de rota. Se a sua equipe está comparando o Veo com o Seedance, rotas no estilo Sora ou outro modelo de vídeo por trás de um único gateway, trate o acesso como um checklist em vez de uma troca de API em uma linha.
Este guia foi verificado em 17 de junho de 2026, Ásia/Shanghai, com base na documentação de vídeo do Veo da API Gemini do Google, na tabela de preços do Veo 3.1 do Google, em uma execução recente do Ahrefs MCP e em um snapshot ao vivo do catálogo de preços da Flatkey. O objetivo não é afirmar que toda rota está pronta para produção hoje. O objetivo é mostrar exatamente o que verificar antes de enviar trabalhos de vídeo cobrados por uso por meio de um roteador multi-provedor.
Resposta Rápida: O Que Verificar para o Acesso à API do Veo
Antes de aprovar o acesso à API do Veo para tráfego de produção, confirme estes sete itens:
- ID oficial do modelo: decida se o fluxo de trabalho precisa de
veo-3.1-generate-preview,veo-3.1-fast-generate-previewouveo-3.1-lite-generate-preview. - Status do ciclo de vida: evite IDs mais antigos do Veo 3.0 e do Veo 2.0, a menos que você esteja lidando com uma migração curta, porque o Google os lista para desativação em 30 de junho de 2026.
- Unidade de preço: normalize o Veo por segundos, resolução e variante antes de compará-lo com provedores de vídeo baseados em tokens/pacotes de recursos.
- Caminho assíncrono do job: registre o nome da operação, o status da pesquisa, a contagem final de vídeos, a duração, a resolução, a contagem de tentativas e o motivo da falha.
- Linha de catálogo da Flatkey: verifique a linha exata do modelo, a família do endpoint, o grupo, o rótulo de preço e o status de disponibilidade no dia em que você encaminhar o tráfego.
- Regra de fallback: decida quando um job com falha no Veo pode mudar para outra rota e quando ele deve falhar de forma fechada por motivos de qualidade ou orçamento.
- Comprovante de uso: execute um pequeno teste e confirme que o painel mostra o modelo selecionado, a rota, o status, a unidade faturável e o responsável pelo custo.
Essa é a versão prática do acesso à API do Veo: não apenas “posso chamar o Veo”, mas “posso provar qual rota de vídeo foi executada, quanto custou e o que acontece quando ela falha”.
Lista de verificação de acesso à API Veo
| Item da lista de verificação | Por que isso importa | Evidência a salvar |
|---|---|---|
| ID do modelo | As variantes do Veo não são intercambiáveis em custo, latência, resolução ou suporte a rotas. | ID oficial do modelo do Google mais a linha correspondente do Flatkey. |
| Família de endpoint | Uma rota de vídeo pode não se comportar como uma conclusão de chat, mesmo que o gateway exponha uma superfície compatível com OpenAI. | Tipo de endpoint, modelo de solicitação, parâmetros aceitos e formato da resposta. |
| Unidade de precificação | O Veo é listado por segundo, enquanto outros provedores de vídeo podem usar tokens, mídia gerada ou pacotes de recursos. | Variante, resolução, segundos esperados, política de nova tentativa e data da fonte do preço. |
| Registro de operação assíncrona | A geração do Veo usa um fluxo de envio e consulta, então uma ação do usuário pode criar vários eventos internos. | ID da operação, tentativas de consulta, status final, metadados do vídeo gerado e contagem de novas tentativas. |
| Status de disponibilidade | Uma linha do catálogo não é o mesmo que uma rota de produção bem-sucedida. | Status do painel, horário da última verificação, resposta de teste e entrada do log de uso. |
| Limite de fallback | Trocar modelos de vídeo pode alterar estilo, duração, qualidade, comportamento da política e custo. | Matriz de fallback aprovada e condições de falha fechada. |
Confirme o modelo oficial Veo e o ciclo de vida
A documentação da API Gemini do Google atualmente usa veo-3.1-generate-preview nos exemplos de geração do Veo. A tabela de preços lista três IDs de prévia do Veo 3.1: veo-3.1-generate-preview, veo-3.1-fast-generate-preview e veo-3.1-lite-generate-preview. Este é o primeiro ponto de partida para uma revisão de acesso à API do Veo, porque um catálogo de gateway pode conter IDs antigos, aliases e rótulos específicos do provedor ao mesmo tempo.
O ciclo de vida é tão importante quanto o ID atual. A página de preços do Google verificada para este artigo alerta que os modelos Veo 3 veo-3.0-generate-001 e veo-3.0-fast-generate-001 estão descontinuados e programados para serem encerrados em 30 de junho de 2026. Ela também diz que o Veo 2 veo-2.0-generate-001 está descontinuado e programado para o mesmo encerramento em 30 de junho de 2026. Se um exemplo de código antigo, rota salva ou favorito do painel ainda apontar para lá, trate isso como uma tarefa de migração, não como um caminho de acesso liberado.
Normalize o preço da API Veo antes de comparar rotas
Para acesso à API Veo, o preço de destaque só é útil depois que você normaliza a solicitação. A precificação paga atual do Veo 3.1 do Google é सूचीada por segundo em USD, com linhas diferentes para as variantes Standard, Fast e Lite.
| Variantes do Veo 3.1 | ID oficial do modelo | Preço verificado | Observação de planejamento |
|---|---|---|---|
| Standard | veo-3.1-generate-preview |
$0.40/seg em 720p ou 1080p; $0.60/seg em 4K. | Use quando os requisitos de qualidade justificarem a linha padrão mais alta. |
| Fast | veo-3.1-fast-generate-preview |
$0.10/seg em 720p; $0.12/seg em 1080p; $0.30/seg em 4K. | Teste a qualidade da saída e a latência antes de direcionar aqui os jobs voltados ao usuário. |
| Lite | veo-3.1-lite-generate-preview |
$0.05/seg em 720p; $0.08/seg em 1080p; 4K não é suportado. | Útil para rascunhos de menor custo quando 4K não for necessário. |
A página de preços do Google também informa que você só é cobrado se o vídeo for gerado com sucesso. Isso não elimina a necessidade de registrar tentativas. Uma operação com falha, um prompt alterado ou uma nova execução solicitada pelo usuário ainda podem criar outro job faturável depois. Sua checklist de acesso à API Veo deve incluir duração, resolução, variante, status de sucesso e contagem de tentativas para cada solicitação.
Se você estiver comparando o Veo com outros provedores, use a mais ampla comparação de preços de API de geração de vídeo por IA como o hub de normalização. Não compare diretamente uma linha por segundo do Veo com um provedor baseado em token/pacote de recursos sem traduzir a forma real da solicitação.
Trate a Geração do Veo Como Uma Operação de Longa Duração
O guia do Veo do Google mostra um fluxo de operação de longa duração: envie a solicitação de geração, faça polling da operação até que ela seja concluída e, então, recupere o vídeo gerado. Isso torna o acesso à API do Veo diferente de uma solicitação de texto normal com uma única resposta. Seu roteador e painel precisam preservar o estado do trabalho entre os polls, e não apenas capturar a primeira chamada HTTP.
Um log pronto para produção deve responder a estas perguntas:
- Qual aplicação, chave da equipe, ambiente e fluxo de trabalho criaram o trabalho de vídeo?
- Qual ID do modelo Veo, proporção de aspecto, resolução, tipo de prompt e mídia de entrada foram usados?
- Qual ID de operação ou equivalente de handle assíncrono foi retornado?
- Quantas tentativas de polling foram executadas antes da conclusão ou falha?
- O trabalho foi bem-sucedido, falhou, foi cancelado, reprocessado ou encaminhado para outro lugar?
- Quantos vídeos gerados foram retornados, e onde a saída foi armazenada?
- Qual registro de uso e registro de custo a equipe financeira pode reconciliar depois?
É também aqui que a compatibilidade de endpoint precisa de um teste real. Um gateway pode expor uma URL base compatível com OpenAI para muitas famílias de modelos, mas a geração de vídeo frequentemente tem campos específicos do provedor e semântica assíncrona. Mantenha os snippets de código como modelos até que você tenha testado uma chave Flatkey atual, uma linha de modelo Veo atual e o corpo exato da solicitação que sua aplicação usará.
Verificar Linhas do Catálogo Flatkey Antes da Produção
O catálogo público de preços da Flatkey foi verificado para este artigo em 17 de junho de 2026, Asia/Shanghai. A resposta continha 638 linhas de modelo e a versão de preços a42d372ccf0b5dd13ecf71203521f9d2. Havia linhas relacionadas ao Veo, incluindo IDs e aliases no estilo Google, como veo-3.1-generate-preview, veo-3.1-fast-generate-preview, veo-3.1-lite-generate-preview, veo3.1, veo3.1-fast e veo3.1-pro.
A ressalva importante: cada linha do Veo verificada naquele instantâneo mostrou o status de disponibilidade unknown_failure. Isso significa que o artigo pode usar as linhas como evidência datada do catálogo, mas não deve afirmar prontidão para produção ao vivo. O fluxo correto de Veo API access é abrir a página de preços atual da Flatkey, confirmar a linha exata, verificar o rótulo do painel, checar a família do endpoint e executar um pequeno teste de validação antes de enviar tráfego de produção.
| Linha da Flatkey Verificada | Tipos de Endpoint Vistos | Campos de Preço Vistos | Status no Instantâneo |
|---|---|---|---|
veo-3.1-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.4 |
unknown_failure |
veo-3.1-fast-generate-preview |
gemini, openai |
quota_type: 1, model_price: 0.15 |
unknown_failure |
veo-3.1-lite-generate-preview |
gemini, openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
veo3.1, veo3.1-fast, veo3.1-pro |
openai |
model_ratio: 37.5, completion_ratio: 1 |
unknown_failure |
A comunicação pública de produto da Flatkey dá suporte a uma narrativa cuidadosa de roteamento: uma chave de API, preços claros, cobrança unificada, um painel para chaves, uso e roteamento, além de linguagem sobre alternância automática/balanceamento de carga. Mantenha a prova de implementação mais restrita do que a promessa de marketing. Para Veo API access, o teste de aceitação deve ser um registro real de solicitação respaldado pelo painel, e não apenas uma linha do catálogo.
Definir Regras de Roteamento de Vídeo Multi-Provedor
O failover de vídeo é mais sensível do que o failover de texto. Se um job do Veo falhar, alternar para outro provedor pode alterar a duração, o estilo visual, a interpretação do prompt, os filtros de conteúdo, o formato de saída e o preço. Um plano de acesso à API do Veo deve definir quando o fallback automático é seguro e quando o fluxo de trabalho deve ser interrompido para revisão humana.
| Situation | Suggested Routing Decision | Reason |
|---|---|---|
| Erro transitório do provedor ou timeout | Tente novamente uma vez ou mude para uma rota equivalente aprovada, se o fluxo de trabalho permitir. | Protege a experiência do usuário sem ocultar falhas repetidas. |
| ID de modelo descontinuado | Bloqueie a rota e migre para um modelo atual antes do tráfego de produção. | Evita a dependência silenciosa de uma rota com data de desligamento fixa. |
| Parâmetro de solicitação não compatível | Falhe de forma fechada e corrija a solicitação do cliente. | O fallback às cegas geralmente repete a mesma solicitação inválida em outro lugar. |
| Render final em alta resolução | Exija aprovação explícita para fallback para uma rota mais cara. | A resolução e a duração aumentam rapidamente o custo do vídeo. |
| Rascunho ou iteração criativa interna | Permita fallback de menor custo somente se as diferenças de saída forem aceitáveis. | Fluxos de trabalho de rascunho podem tolerar mais variação do que resultados voltados ao cliente. |
O lado da confiabilidade dessa decisão é abordado com mais profundidade no playbook de balanceamento de carga e failover de API de IA. Para vídeo, adicione restrições de custo e de saída criativa a cada ladder de fallback.
Execute Este Teste de Fumaça Antes do Lançamento
Um teste de fumaça responsável de acesso à API Veo deve ser pequeno, controlado e fácil de inspecionar:
- Crie ou selecione uma chave Flatkey de não produção.
- Escolha uma linha atual do Veo na página de preços ao vivo e registre seu rótulo exato de modelo.
- Confirme a família do endpoint e o modelo de solicitação com o responsável pelo produto/docs.
- Execute um trabalho de vídeo de baixo risco com configurações conhecidas de duração e resolução.
- Capture o ID da operação, o caminho de polling de status, o resultado final, a unidade faturável e a entrada do log de uso.
- Repita com uma falha controlada quando possível, como um modelo descontinuado bloqueado ou um parâmetro sem suporte.
- Decida se a rota pode atender tráfego de produção, apenas staging ou apenas o backlog de pesquisa.
Se qualquer uma dessas verificações falhar, mantenha a rota fora da produção. Um log de uso ausente, uma unidade de preço pouco clara ou um status de disponibilidade unknown_failure não é um problema burocrático para vídeo; isso muda custo, suporte e expectativas do cliente.
Perguntas frequentes
Como faço para obter acesso à API Veo?
Comece com a documentação atual da API Gemini do Google sobre Veo e com os requisitos de cobrança, depois verifique o ID do modelo, o endpoint e a precificação no dia em que você construir. Se você usar a Flatkey para roteamento, confira o catálogo de preços atual e o painel antes de considerar o acesso à API Veo pronto para produção.
Qual ID de modelo Veo devo usar?
A tabela de preços atual do Veo 3.1 do Google lista veo-3.1-generate-preview, veo-3.1-fast-generate-preview e veo-3.1-lite-generate-preview. Evite os IDs mais antigos do Veo 3.0 e do Veo 2.0 para novos trabalhos em produção, porque o Google os lista para desativação em 30 de junho de 2026.
Como a precificação da API Veo é calculada?
O Google lista a precificação do plano pago do Veo 3.1 por segundo, com tarifas diferentes por variante e resolução. Para o acesso à API Veo, normalize os segundos esperados, a resolução, a política de sucesso e as tentativas antes de comparar a rota com provedores de vídeo baseados em tokens ou pacotes de recursos.
O Veo pode ser roteado com outros modelos de geração de vídeo?
Sim, mas somente depois de definir o contrato da rota. Um fallback do Veo para outro modelo de vídeo pode alterar a qualidade visual, a duração, o formato de saída, o comportamento de moderação e o custo. Use regras de fallback aprovadas em vez de tentativas automáticas genéricas.
O que os usuários da Flatkey devem verificar antes da produção?
Verifique a linha atual do modelo, a família do endpoint, o rótulo do painel, o status de disponibilidade, o rótulo de preço, os campos do log de uso e um resultado real de teste rápido. No snapshot de 17 de junho de 2026 usado para este artigo, as linhas do Veo existiam, mas mostravam unknown_failure, então o uso em produção exige confirmação recente.
Conclusão
O acesso à API Veo é uma decisão de produção, não apenas uma opção de fornecedor. Confirme o modelo oficial, normalize segundos e resolução, trate jobs assíncronos, verifique a linha atual da Flatkey e as evidências do painel, e documente os limites de fallback antes da primeira solicitação de vídeo voltada ao cliente.
Para avaliar o Veo junto com o restante da sua stack de modelos de vídeo, comece com o catálogo atual de preços da Flatkey e use a checklist acima para decidir quais rotas estão prontas para staging, quais precisam de um smoke test e quais devem permanecer no backlog de pesquisa.
