Limites de taxas

Os limites de taxa regulam o número de solicitações que você pode fazer à API Gemini em um determinado período. Esses limites ajudam a manter o uso justo, proteger contra abusos e manter o desempenho do sistema para todos os usuários.

Ver os limites de taxa ativos no AI Studio

Como funcionam os limites de taxa

Os limites de taxa geralmente são medidos em três dimensões:

• Solicitações por minuto (RPM)
• Tokens por minuto (entrada) (TPM)
• Solicitações por dia (RPD)

Seu uso é avaliado em relação a cada limite, e exceder qualquer um deles vai acionar um erro de limitação de taxa. Por exemplo, se o limite de RPM for 20, fazer 21 solicitações em um minuto vai resultar em um erro, mesmo que você não tenha excedido o TPM ou outros limites.

Os limites de taxa são aplicados por projeto, não por chave de API. As cotas de solicitações por dia (RPD) são redefinidas à meia-noite do horário do Pacífico.

Os limites variam de acordo com o modelo específico usado, e alguns limites se aplicam apenas a modelos específicos. Por exemplo, as imagens por minuto (IPM) só são calculadas para modelos capazes de gerar imagens (Nano Banana), mas são conceitualmente semelhantes aos TPM. Outros modelos podem ter um limite de tokens por dia (TPD).

A limitação de taxa é mais restrita para modelos experimentais e de prévia.

Limitação de taxa com base em gastos

Além dos limites de solicitações por minuto (RPM) e tokens por minuto (TPM), a API Gemini aplica limites de taxa com base em gastos para proteger contra cobranças inesperadas. Se esses limites se aplicam à sua conta, isso depende do seu histórico de faturamento e do nível de uso.

A tabela a seguir mostra os limites de taxa com base em gastos para cada nível de uso. Esses limites são avaliados em uma janela contínua de 10 minutos. A aplicação desses limites à sua conta depende do histórico de faturamento e da situação da conta.

Nível de uso	Limite de taxa de gastos (a cada 10 minutos)
Free (link em francês)	N/A
Nível 1	US$ 10
Nível 2	US$ 50
Nível 3	US$ 200

Se você atingir um limite de taxa com base em gastos, a API vai retornar um erro 429 RESOURCE_EXHAUSTED. Para solucioná-lo:

• Aguarde e tente de novo depois de um curto período.
• Reduza a taxa de solicitações caras, por exemplo, usando janelas de contexto menores ou saídas mais curtas.
• Se você atingir esse limite de forma consistente durante o uso normal, solicite um aumento do limite de taxa.

Níveis de uso

Os limites de taxa estão vinculados ao nível de uso do projeto. À medida que o uso e os gastos com a API aumentarem, você vai receber um upgrade automático para um nível mais alto com limites de taxa maiores.

As qualificações para os níveis 2 e 3 são baseadas no gasto total acumulado nos serviços do Google Cloud (incluindo, entre outros, a API Gemini) para a conta de faturamento vinculada ao seu projeto.

Nível de uso	Qualificação	Limite do nível de faturamento
Free (link em francês)	Projeto ativo ou teste sem custo financeiro	N/A
Nível 1	Configurar e vincular uma conta de faturamento ativa	US$ 250,00
Nível 2	Pagamento de US $100 + 3 dias após o primeiro pagamento bem-sucedido	US$ 2.000
Nível 3	Pagou US $1.000 + 30 dias desde o primeiro pagamento bem-sucedido	US$ 20.000 a US$ 100.000+

Embora o cumprimento dos critérios de qualificação declarados geralmente seja suficiente para aprovação, em casos raros, uma solicitação de upgrade pode ser negada com base em outros fatores identificados durante o processo de análise.

Esse sistema ajuda a manter a segurança e a integridade da plataforma da API Gemini para todos os usuários.

Limites de taxa da API Gemini

Os limites de taxa dependem de vários fatores, como seu nível de uso, e podem ser consultados no Google AI Studio. À medida que o nível e o status da conta mudam ao longo do tempo, os limites de taxa são atualizados automaticamente.

Ver os limites de taxa ativos no AI Studio

Os limites de taxa especificados não são garantidos, e a capacidade real pode variar.

Limites de taxa de inferência prioritária

O consumo de prioridade tem os próprios limites de taxa, mesmo que o consumo seja contabilizado nos limites gerais de taxa de tráfego interativo. Os limites de limitação de taxa padrão são: 0,3 vezes o limite de limitação de taxa padrão para cada modelo e nível

Limites de taxa da API Batch

As solicitações da API Batch estão sujeitas aos próprios limites de taxa, separados das chamadas de API que não são em lote.

• Solicitações em lote simultâneas:100
• Limite de tamanho do arquivo de entrada:2 GB
• Limite de armazenamento de arquivos:20 GB
• Tokens em fila por modelo:a tabela Tokens em fila em lote lista o número máximo de tokens que podem ser colocados em fila para processamento em lote em todos os jobs em lote ativos para um determinado modelo.

Como fazer upgrade para o próximo nível

Para fazer a transição do nível sem custo financeiro para um nível pago, primeiro é necessário configurar o faturamento no AI Studio.

Quando o projeto atender aos critérios especificados, ele será automaticamente atualizado para o próximo nível. Os upgrades do nível sem custo financeiro para o nível 1 geralmente entram em vigor instantaneamente, e os upgrades de nível subsequentes entram em vigor em até 10 minutos. Acesse a página Projetos no AI Studio para conferir seus níveis.

Solicitar um aumento no limite de taxa

Cada variação de modelo tem um limite de taxa associado (solicitações por minuto, RPM). Para mais detalhes sobre esses limites de taxa, consulte a página Limite de taxa do AI Studio.

Solicitar aumento do limite de taxa do nível pago

Não podemos garantir um aumento no limite de taxa, mas faremos o possível para analisar seu pedido.