Limites de taxas

Os limites de taxa regulam o número de solicitações que você pode fazer para a 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 seus 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 (Imagen 3), mas são conceitualmente semelhantes aos TPM. Outros modelos podem ter um limite de token por dia (TPD).

Os limites de taxa são mais restritos para modelos experimentais e de prévia.

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 aumentam, você tem a opção de fazer upgrade 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 em serviços do Google Cloud (incluindo, entre outros, a API Gemini) para a conta de faturamento vinculada ao seu projeto.

Nível	Requisitos
Grátis	Usuários em países qualificados
Nível 1	Conta de faturamento paga vinculada ao projeto
Nível 2	Gasto total: > US$ 250 e pelo menos 30 dias desde o pagamento bem-sucedido
Nível 3	Gasto total: > US$ 1.000 e pelo menos 30 dias desde o pagamento bem-sucedido

Quando você solicita um upgrade, nosso sistema automatizado de proteção contra abuso realiza verificações adicionais. Embora atender aos critérios de qualificação declarados seja geralmente 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 revisão.

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 cota, e podem ser vistos no Google AI Studio. À medida que seu nível e o status da conta mudam com o tempo, os limites de taxa são atualizados automaticamente.

Ver seus 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 da API em lote

As solicitações da API em lote estão sujeitas a limites de taxa próprios, separados das chamadas de API sem 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 enfileirados por modelo:a coluna Tokens enfileirados em lote na tabela de limites de taxa lista o número máximo de tokens que podem ser enfileirados para processamento em lote em todos os seus jobs em lote ativos para um determinado modelo. Consulte a tabela de limites de taxa de API padrão.

Como fazer upgrade para o próximo nível

A API Gemini usa o Cloud Billing para todos os serviços de faturamento. Para fazer a transição do nível sem custo financeiro para um nível pago, primeiro ative o faturamento do Cloud no seu projeto do Google Cloud.

Quando seu projeto atender aos critérios especificados, ele vai se qualificar para um upgrade para o próximo nível. Para solicitar um upgrade, siga estas etapas:

• Acesse a página de chaves de API no AI Studio.
• Localize o projeto que você quer atualizar e clique em "Fazer upgrade". A opção "Fazer upgrade" só vai aparecer para projetos que atendem às qualificações do próximo nível.

Após uma validação rápida, o projeto será atualizado para o próximo nível.

Solicitar um aumento no limite de taxa

Cada variação de modelo tem um limite de taxa associado (solicitações por minuto, RPM). Para detalhes sobre esses limites de taxa, consulte Modelos do Gemini.

Solicitar um aumento no limite de taxa do nível pago

Não podemos garantir que vamos aumentar seu limite de taxa, mas faremos o possível para analisar seu pedido.