WaveSpeedAI

Veo 429 RESOURCE_EXHAUSTED em um projeto pago da Gemini API: causas e soluções

O Veo 3.1 retorna 429 RESOURCE_EXHAUSTED mesmo que seu projeto da Gemini API seja pago e a cota apareça como não utilizada. As seis causas, como verificar cada uma e outra forma de chamar o Veo.

By WaveSpeedAI9 min read

Se uma requisição do Veo pela Gemini API falha com 429 RESOURCE_EXHAUSTED em um projeto pago, a causa é uma de seis: a cota diária de requisições do Veo, um limite baseado em gastos, a chave pertencer a um projeto diferente daquele que você atualizou, um saldo pré-pago zerado, um nível de uso diferente do que você imagina, ou uma cota que nunca foi provisionada corretamente para o projeto. As quatro primeiras você mesmo pode resolver. As duas últimas dependem do Google.

Este guia mostra como distingui-las e o que fazer enquanto você espera.

Fontes consultadas em 22 de novembro de 2026: a documentação de limites de taxa e de solução de problemas da Gemini API do Google, e tópicos do Google AI Developers Forum linkados abaixo.

Como o erro aparece

429 RESOURCE_EXHAUSTED
You exceeded your current quota, please check your plan and billing details.

Desenvolvedores relatam o erro em veo-3.1-generate-preview, veo-3.1-fast-generate-preview e veo-3.1-lite-generate-preview, muitas vezes enquanto os modelos de texto e imagem na mesma chave continuam funcionando.

Como funcionam os limites da Gemini API

Quatro afirmações da documentação de limites de taxa do Google explicam a maioria dos casos:

  • “Os limites de taxa são aplicados por projeto, não por chave de API.”
  • “As cotas de requisições por dia (RPD) são redefinidas à meia-noite, no horário do Pacífico.”
  • “Os limites de taxa são mais restritos para modelos experimentais e de preview.” Os modelos Veo 3.1 acima são modelos de preview.
  • “Os limites de taxa especificados não são garantidos e a capacidade real pode variar.”

Os níveis são atribuídos de acordo com o histórico de cobrança:

NívelComo se qualificar
FreeUm projeto ativo
Tier 1“Configurar e vincular uma conta de cobrança ativa”
Tier 2“Pagar US$ 100 + 3 dias desde o primeiro pagamento bem-sucedido”
Tier 3“Pagar US$ 1.000 + 30 dias desde o primeiro pagamento bem-sucedido”

Além dos limites de requisições, os níveis pagos têm limites baseados em gastos, medidos em uma janela móvel de 10 minutos, e ultrapassar um deles também retorna 429 RESOURCE_EXHAUSTED. Vídeo é o que há de mais caro para pedir, então uma rajada curta de jobs do Veo atinge um limite de gastos muito antes do que o tráfego de texto.

As seis causas

1. Você usou a cota diária do Veo

Nos tópicos do fórum, projetos Tier 1 mostram um limite do Veo de 2 requisições por minuto e 10 requisições por dia por modelo. Dez clipes são uma tarde de testes. Tentar de novo não ajuda; o contador é redefinido à meia-noite, no horário do Pacífico.

2. Você atingiu o limite de gastos

Vários clipes enviados em dez minutos podem ultrapassar o limite de gastos do Tier 1 mesmo quando o contador de requisições ainda tem folga. Espace os jobs ou migre para um nível mais alto.

3. A chave é de outro projeto

Limites e níveis pertencem ao projeto. Se você ativou a cobrança em um projeto e seu código usa uma chave criada em outro, você continua sujeito aos limites desse outro projeto. Criar uma nova chave no mesmo projeto não muda nada.

4. O saldo pré-pago está zerado

A orientação do fórum do Google sobre erros 429 diz que um saldo pré-pago esgotado também interrompe as respostas. Verifique o saldo antes de olhar as cotas.

5. O nível não é o que você pagou

Em um tópico de agosto de 2026, um desenvolvedor cujo projeto havia sido confirmado como Tier 2 o encontrou de volta no Tier 1 poucos dias depois, com o limite diário do Veo caindo de 50 para 10 e a geração falhando. O suporte de cobrança não conseguiu alterar isso; uma resposta no tópico apontou um formulário para reportar rebaixamentos inesperados de nível, e o problema foi resolvido dois dias depois.

6. A cota aparece como não utilizada e você ainda recebe 429

Este é o caso sem correção por autoatendimento. Em um tópico de setembro de 2026, um desenvolvedor do Tier 1 com saldo pré-pago positivo viu 0/2 RPM e 0/10 RPD para todos os modelos Veo no painel e ainda assim recebeu 429 na primeira requisição, enquanto outras chamadas do Gemini na mesma chave funcionavam. Um segundo desenvolvedor relatou os mesmos números. A única resposta pediu o id do projeto e o horário de uma requisição com falha. Um tópico anterior, de junho, descreve a cota diária sem ser redefinida por mais de 48 horas; ele foi fechado automaticamente sem resposta.

Verifique nesta ordem

  1. A qual projeto a chave pertence? Abra a chave no AI Studio e anote o projeto. Confirme que esse projeto, e não outro, tem a cobrança vinculada.
  2. Em que nível esse projeto está? Leia na página de limites de taxa do projeto, não em um e-mail de confirmação.
  3. O que a linha do Veo mostra? Se o RPD está no máximo, espere a meia-noite do horário do Pacífico. Se mostra cota não utilizada, continue.
  4. Há saldo pré-pago, e algum teto de gastos foi atingido?
  5. Você enviou vários jobs de vídeo em poucos minutos? Espere dez minutos e envie exatamente um.
  6. Ainda falha com cota não utilizada? Reúna o id do projeto, o id do modelo, o horário em UTC de uma requisição com falha e uma captura de tela da página de limites de taxa. Publique-os no Google AI Developers Forum e, se o nível parecer errado, use o formulário de rebaixamento de nível mencionado no tópico acima. O Google declara: “Não oferecemos garantias de aumento do seu limite de taxa.”

Trate o erro corretamente no código

O guia de solução de problemas do Google recomenda backoff exponencial para 429. Isso é correto para um limite por minuto e inútil para um limite diário, então limite as tentativas e depois pare.

import random
import time

def call_with_backoff(submit, max_attempts=4):
    for attempt in range(max_attempts):
        try:
            return submit()
        except Exception as err:
            if "RESOURCE_EXHAUSTED" not in str(err):
                raise
            if attempt == max_attempts - 1:
                # Limites por minuto são liberados em poucas tentativas.
                # Se ainda estamos aqui, é um limite diário ou da conta:
                # pare de tentar e mude para a segunda rota.
                raise
            time.sleep(min(60, 2 ** attempt * 5) + random.random())

Coloque os jobs de vídeo em fila em vez de enviá-los em paralelo e mantenha um contador de requisições por modelo por dia no horário do Pacífico, para saber que está perto do limite antes que o Google avise.

Outra forma de chamar o Veo

Se o seu produto depende do Veo e um dia de dez requisições não é suficiente, você precisa de uma segunda rota que não passe pela mesma cota de projeto. A alternativa do próprio Google é o Vertex AI, que tem cotas separadas e exige uma configuração no Google Cloud.

A WaveSpeedAI oferece o Veo 3.1 e o Veo 3.1 Fast por meio de sua API, para text-to-video e image-to-video:

  • Disponível para qualquer conta com créditos. Não há cota de preview a solicitar.
  • Pague por requisição. O preço das configurações que você escolher é exibido na página do modelo antes de você executar.
  • Sem cold starts, e tarefas com falha são reembolsadas integralmente.
  • Uma única API para todos os modelos. As mesmas duas chamadas funcionam para Veo, Kling, Seedance, Wan e o restante do catálogo, então um segundo modelo é um fallback que você adiciona em minutos.
curl --request POST 'https://api.wavespeed.ai/api/v3/google/veo3.1-fast/text-to-video' \
  --header "Authorization: Bearer $WAVESPEED_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"prompt": "A paper boat drifting down a rain-soaked street at dusk, cinematic, shallow depth of field"}'
curl --request GET "https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result" \
  --header "Authorization: Bearer $WAVESPEED_API_KEY"

A primeira chamada retorna data.id; a segunda retorna data.status e, quando concluída, a URL do vídeo em data.outputs. Os limites de taxa dependem do nível da sua conta e estão listados na documentação.

Para testar sem código, abra o gerador de vídeo.

FAQ

Por que recebo 429 RESOURCE_EXHAUSTED no Veo quando minha cota mostra 0 usado?

Ou a chave pertence a um projeto diferente daquele cuja cota você está vendo, ou um limite de gastos ou um saldo pré-pago zerado está bloqueando a requisição, ou a cota do Veo não está funcionando corretamente para o projeto. Vários desenvolvedores relataram o último caso em projetos pagos do Tier 1 em 2026; é preciso que o Google examine o projeto.

Qual é o limite de taxa do Veo no Tier 1 da Gemini API?

A página de limites de taxa do Google não lista o Veo. Em relatos de desenvolvedores de 2026, os painéis do Tier 1 mostram 2 requisições por minuto e 10 requisições por dia para cada modelo Veo. Consulte a página de limites de taxa do seu próprio projeto para ver os números atuais.

Quando a cota diária do Veo é redefinida?

À meia-noite, no horário do Pacífico, segundo a documentação do Google.

Uma nova chave de API resolve o 429?

Não, se ela for criada no mesmo projeto. Os limites se aplicam por projeto, não por chave.

Como obtenho um limite maior do Veo?

Alcance o próximo nível pelo histórico de pagamentos (para o Tier 2, US$ 100 pagos e três dias desde o primeiro pagamento bem-sucedido) ou envie o formulário de aumento de limite de taxa do Google. O Google não garante um aumento.

Posso usar o Veo sem uma cota da Gemini API?

Sim. O Vertex AI tem suas próprias cotas, e plataformas como a WaveSpeedAI oferecem o Veo 3.1 por meio de sua própria API com preço por requisição.

Compartilhar