Este guia oferece uma visão geral das diferentes opções de faturamento da API Gemini, explica como ativar o faturamento e monitorar o uso e fornece respostas para perguntas frequentes sobre o faturamento.
Sobre faturamento e níveis
O faturamento da API Gemini é baseado no seu histórico de pagamentos.
| 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 | US $100 + 3 dias após o primeiro pagamento concluído | US$ 2.000 |
| Nível 3 | Pago US $1.000 + 30 dias após o primeiro pagamento concluído | US$ 20.000 a US$ 100.000 ou mais |
As novas contas começam no nível sem custo financeiro, que permite o acesso a determinados modelos na API Gemini e no AI Studio, até os limites de taxa do nível sem custo financeiro dos modelos.
Para acessar limites de taxa mais altos, usar modelos avançados e garantir que seus comandos e respostas não sejam usados para melhorar os produtos do Google*, vincule uma conta de faturamento e faça uma pré-pagamento para mudar para os planos pagos. Em seguida, você vai passar para níveis mais altos com base no gasto acumulado e na idade da conta. No nível 3, talvez você possa mudar para o faturamento pós-pago.
Os níveis, os limites de taxa e os limites máximos da conta de faturamento são determinados no nível da conta de faturamento.
* Privacidade de dados de nível empresarial: para mais informações sobre o uso de dados para serviços pagos, consulte os Termos de Serviço.
Configurar o faturamento para acessar o nível pago
É possível criar um projeto e configurar o faturamento ou importar um projeto existente para fazer upgrade para o nível pago no Google AI Studio. Fazer upgrade do nível sem custo financeiro para o nível pago significa vincular uma conta de faturamento e fazer um pré-pagamento para adicionar um mínimo de US $10 (ou o equivalente em outras moedas) de créditos à sua conta.
- Acesse a página Chaves de API, Projetos ou qualquer lugar em que o botão Configurar faturamento apareça no AI Studio.
- Por padrão, os novos usuários têm um projeto e uma chave de API criados para eles.
- Se você precisar de uma nova chave, clique em Criar chave de API e siga a caixa de diálogo para adicionar um par chave-projeto à tabela.
- Encontre o projeto do nível sem custo financeiro que você quer fazer upgrade para o nível pago e clique em Configurar faturamento na coluna Nível de faturamento.
- Se você nunca configurou uma conta de faturamento do Google:
- Você vai precisar selecionar seu país para concordar com os Termos de Serviço.
- Em seguida, preencha ou confirme suas informações de contato e forma de pagamento para continuar.
- Se você já configurou contas de faturamento do Google:
- Será necessário escolher uma das suas contas de faturamento.
- Se não quiser usar nenhuma das suas contas, clique em Adicionar nova conta de faturamento e preencha ou confirme suas informações de contato e forma de pagamento para continuar.
- Em seguida, você vai:
- Foi solicitado um pré-pagamento mínimo de US $10 para concluir a configuração do faturamento (ou seja, sua conta foi atribuída automaticamente ao plano de faturamento pré-pago).
- Escolha entre os planos de faturamento pré-pago e pós-pago para sua conta.
- Atribuído a um plano de faturamento pós-pago por um período intermediário até que o novo sistema pré-pago seja propagado para todos os usuários (a partir de 23 de março de 2026).
- Depois de fazer o pré-pagamento ou selecionar o pós-pago, a configuração da conta será concluída.
Fazer upgrade para o próximo nível pago
Se você já estiver em um nível pago e atender aos critérios para uma mudança de plano, vai receber um upgrade automático para o próximo nível (sujeito a tempos de processamento).
Verificar o status de faturamento
Depois de vincular uma conta de faturamento ao seu projeto, você pode monitorar o status dela na página de faturamento do AI Studio. Ao contrário do nível sem custo financeiro, o status do nível pago é dinâmico. Embora seu nível de uso seja determinado pelo histórico da conta, a API Gemini só vai atender às solicitações se você tiver um saldo de crédito pré-pago positivo.
Na página Projetos, é possível conferir o nível e o plano de faturamento do projeto na coluna Nível de faturamento. Todas as ações de status de faturamento que você precisa realizar em um projeto são mostradas nas colunas Nível de faturamento ou Status:
- Configurar faturamento se o projeto não tiver uma conta de faturamento vinculada.
- Configurar pré-pagamento se o projeto tiver uma conta de faturamento anexada, mas precisar usar um plano de faturamento pré-pago que precisa ser configurado.
- "Nenhum crédito disponível" se a conta de faturamento for necessária para comprar créditos, mas a conta para pagamentos de pré-pagamento não estiver configurada ou o saldo de crédito disponível estiver esgotado.
Clique em qualquer uma das mensagens para continuar com as ações necessárias.
Monitorar o uso
É possível monitorar o uso da API Gemini no Google AI Studio em Painel > Uso.
Planos de faturamento
Os planos de faturamento da API Gemini e do AI Studio se enquadram em duas categorias que determinam quando você paga pelo uso: pré-pago e pós-pago. Você pode verificar seu plano de faturamento atribuído e gerenciar as formas de pagamento na página Faturamento do AI Studio.
Pré-pagamento
No plano de faturamento pré-pago, você compra créditos para seu saldo pré-pago antes de usar a API Gemini, e os custos de uso da API são deduzidos do saldo de crédito pré-pago em quase em tempo real. Você pode fazer um pré-pagamento adicionando créditos à sua conta ou configurando a recarga automática. Depois da compra, os créditos não usados expiram após 12 meses e não são reembolsáveis, exceto depois de mudar para uma conta pós-paga.
Quando o saldo de crédito pré-pago na conta de faturamento chegar a US $0, todas as chaves de API em todos os projetos vinculados a essa conta de faturamento vão parar de funcionar simultaneamente. Os créditos pré-pagos se aplicam apenas aos custos de uso da API Gemini. Eles não podem ser usados para pagar outros serviços do Google Cloud.
Os novos usuários usam o plano de faturamento pré-pago por padrão. Os projetos anteriores à introdução dos planos de faturamento pré-pago e pós-pago talvez precisem atualizar os detalhes de faturamento do projeto antes de continuar usando a API Gemini.
Comprar créditos
Você pode comprar créditos manualmente antes de usar a API Gemini para carregá-los no saldo de crédito da sua conta pré-paga.
Para comprar créditos, acesse a página Faturamento do AI Studio e selecione Comprar créditos. A compra mínima é de US $10. O valor máximo de créditos que você pode pagar antecipadamente é de US$ 5.000.
Atualizar automaticamente
A recarga automática é um recurso opcional que recarrega automaticamente o saldo de crédito pré-pago quando ele está baixo. Isso é útil para evitar interrupções no serviço.
Você pode configurar a recarga automática e conferir o status dela no card Créditos disponíveis na página Faturamento do AI Studio. Clique em Configurar recarga automática ou Gerenciar recarga automática para definir sua forma de pagamento, o valor da recarga e o saldo mínimo que aciona um pagamento de recarga.
Pós-pagamento
No plano de faturamento pós-pagamento, sua conta do Cloud Billing acumula custos, e você recebe uma cobrança automática no fim do mês ou quando os custos atingem um valor limite atribuído automaticamente. O pagamento é cobrado na forma de pagamento anexada à sua conta para pagamentos pós-pagos, que pode ser gerenciada na página Faturamento do AI Studio.
Quando você atender aos critérios do nível 3, poderá mudar manualmente do plano pré-pago para o pós-pago. Para mudar de plano, clique no botão Mudar para pós-pagamento, que aparece no canto superior direito da página Faturamento do AI Studio quando sua conta se qualifica.
Na página Faturamento, você pode conferir seu saldo, datas de vencimento e pagamentos anteriores, além de fazer pagamentos e gerenciar formas de pagamento.
Ao configurar o faturamento de um novo projeto, se você se qualificar para o pós-pagamento, poderá escolher entre pré-pagamento e pós-pagamento na caixa de diálogo configuração de faturamento.
Depois de mudar uma conta do Cloud Billing para usar o plano de faturamento pós-pago, todos os projetos vinculados a essa conta de faturamento também serão mudados para o plano pós-pago. Não é possível mover essa conta de faturamento de volta para o plano de faturamento pré-pago. Você pode mover um projeto para uma conta de faturamento com um plano de faturamento diferente para mudar o ciclo de cobrança dele. Consulte a documentação do Cloud sobre gerenciar o faturamento de projetos.
Saiba mais sobre o ciclo de cobrança pós-pagamento no guia do Cloud Billing.
Limites de gastos
A API Gemini oferece suporte a limites de gastos mensais nos níveis da conta de faturamento e do projeto. Esses controles foram criados para proteger sua conta contra excedentes inesperados e o ecossistema para garantir a disponibilidade do serviço.
Limites de gastos do projeto
É possível definir seus próprios limites de gastos para envolvidos no projeto no AI Studio. Isso é útil se você tiver vários projetos na mesma conta de faturamento e quiser garantir que cada um tenha acesso a um limite de gastos cumulativo suficiente.
As contas com as funções de editor, proprietário ou administrador do projeto podem definir limites de gastos por projeto no AI Studio na página Gasto em Limite de gastos mensais > Editar limite de gastos.
Se você mover um projeto para uma conta de faturamento diferente, o limite de gastos definido para esse projeto vai continuar valendo, mas os gastos acumulados serão redefinidos para US $0 no novo ciclo de faturamento.
As conclusões do modo em lote ainda podem gerar excedentes.
Os tempos de processamento dos dados de faturamento podem ter um pequeno atraso no AI Studio, de até 10 minutos. Você pode ter excedentes além do limite do projeto se os dados de faturamento não forem processados antes de mais cobranças serem acumuladas.
Limites de gastos do nível da conta de faturamento
Cada nível tem um limite máximo de gastos mensais:
| Nível de uso | Limite de gastos |
|---|---|
| Free (link em francês) | N/A |
| Nível 1 | US$ 250,00 |
| Nível 2 | US$ 2.000 |
| Nível 3 | US$ 20.000 a US$ 100.000 |
Os limites de uso mensal são aplicados no nível da conta de faturamento, são predefinidos e não podem ser configurados. O gasto total é agregado em todos os projetos vinculados. Depois que o total acumulado atinge o limite do nível, o serviço é suspenso para todos os projetos vinculados a essa conta de faturamento até o início do próximo ciclo de faturamento (mensal).
Avaliar os gastos da sua conta de faturamento
Para avaliar seu gasto mensal histórico e determinar se os novos limites de gastos dos níveis da conta de faturamento vão afetar seus projetos em andamento, siga estas etapas:
- No console do Google Cloud, acesse a página Relatórios da conta do Cloud Billing.
- Se você tiver mais de uma conta de faturamento, escolha a conta do Cloud Billing que tem os relatórios de custo que você quer visualizar.
- O relatório usa "Agrupar por serviço" como padrão no "Mês atual". Você vai encontrar API Gemini na coluna Serviço e o gasto total na coluna Custo de uso da tabela.
- Para ver custos granulares limitados ao uso da API Gemini, defina o filtro Agrupar por como SKU e o filtro Serviços como API Gemini.
- Ajuste o filtro Período por data de uso para o intervalo desejado e avalie seu gasto histórico em um período.
Tempos de processamento
Os indicadores e atualizações de faturamento nem sempre acontecem em tempo real.
- Uso de crédito: os custos de uso geralmente são descontados do seu saldo em minutos.
- Confirmação do pagamento: embora a maioria dos pagamentos com cartão seja instantânea, algumas formas de pagamento (como transferências bancárias) podem levar vários dias para serem compensadas. Os serviços só são retomados ou atualizados após a confirmação oficial da compra de créditos.
- Upgrades de nível: após um pagamento bem-sucedido ou quando você atende aos critérios de upgrade, os upgrades de nível geralmente são refletidos em até 10 minutos.
- Gráficos de detalhamento do custo total: os gráficos que mostram o detalhamento do custo total nas páginas Faturamento e Gasto podem levar até 24 horas para serem atualizados.
Leia os guias do Cloud Billing sobre ciclo de cobrança e latências de transação para saber mais sobre possíveis atrasos no faturamento.
Reembolsos
Não é possível receber reembolsos para contas de faturamento pré-pagas. Os créditos comprados expiram após um ano. Após o vencimento, os créditos são perdidos e não podem ser recuperados.
Quando uma conta pré-paga muda para o tipo de conta pós-paga (depois que você atende aos critérios e faz upgrade manual da conta), a conta pré-paga é encerrada, e todos os créditos pré-pagos restantes são reembolsados automaticamente para a forma de pagamento registrada.
Se você encerrar sua conta pré-paga por qualquer motivo que não seja o upgrade para pós-paga, todos os créditos pré-pagos restantes serão perdidos.
As contas pós-pagamento seguem a política de reembolso do Google Cloud.
Contas do Cloud Billing
A API Gemini usa contas do Faturamento do Cloud para serviços de faturamento, que você pode configurar diretamente no AI Studio. Use o AI Studio para acompanhar os gastos, entender os custos e fazer pagamentos.
Os níveis, os limites de taxa e os limites máximos da conta de faturamento são determinados no nível da conta de faturamento.
Projetos e chaves de API
Todos os projetos vinculados a uma conta de faturamento do Cloud herdam o nível de uso e os limites de taxa e de conta associados. Se você mudar um projeto de uma conta de faturamento para outra, o nível dele e, consequentemente, os limites de taxa e os limites da conta vão mudar para o nível da nova conta de faturamento.
O gasto cumulativo (em todos os produtos do Google Cloud) e a idade da conta em todos os projetos vinculados a uma conta de faturamento contam para as qualificações de nível dessa conta.
É possível desvincular um projeto da conta de faturamento para voltar ao nível sem custo financeiro.
As chaves de API são credenciais geradas em um projeto. Elas não têm configurações de faturamento independentes. Elas herdam os limites de nível e o status de faturamento do projeto. O uso cumulativo de todas as chaves em um projeto conta para o limite de gastos desse projeto e para o gasto total da conta de faturamento.
Perguntas frequentes
As seções a seguir fornecem respostas para perguntas frequentes.
Por que estou recebendo uma cobrança?
O preço da API Gemini é baseado no seguinte:
- Contagem de tokens de entrada
- Contagem de tokens de saída
- Contagem de tokens em cache
- Duração do armazenamento de tokens em cache
Para informações sobre preços, consulte a página de preços.
Onde posso ver minha cota?
Você pode conferir sua cota e os limites do sistema no AI Studio.
Como solicitar mais cota?
Você vai receber mais cota automaticamente quando sua conta atingir os próximos requisitos de nível.
Posso usar a API Gemini sem custos financeiros no EEE (incluindo a UE), no Reino Unido e na Suíça?
Sim, oferecemos o nível sem custo financeiro e o nível pago em várias regiões.
Se eu configurar o faturamento com a API Gemini, vou receber uma cobrança pelo uso do Google AI Studio?
O uso do AI Studio continua sem custos financeiros, a menos que os usuários vinculem uma chave de API paga para acessar recursos pagos. Depois de vincular uma chave de API paga como parte de um projeto pago no AI Studio, você vai receber uma cobrança pelo uso do AI Studio com essa chave. Você pode alternar entre projetos do nível pago e do nível sem custo financeiro no AI Studio conforme necessário.
Posso usar 1 milhão de tokens no nível sem custo financeiro?
O nível sem custos financeiros da API Gemini varia de acordo com o modelo selecionado. Por enquanto, você pode testar a janela de contexto de 1 milhão de tokens das seguintes maneiras:
- No Google AI Studio
- Com planos sem custos financeiros para modelos selecionados
- Com planos pós-pagos
Como posso calcular o número de tokens que estou usando?
Use o método GenerativeModel.count_tokens
para contar o número de tokens. Consulte o guia de tokens para saber mais sobre eles.
Posso usar meu crédito de boas-vindas do Google Cloud com a API Gemini?
Não, o crédito de boas-vindas ou o crédito de teste sem custo financeiro do Google Cloud não podem ser usados na API Gemini ou no AI Studio.
Se você recebeu um crédito de boas-vindas do Google Cloud antes de ele se tornar inadequado, poderá gastar os créditos restantes na API Gemini e no AI Studio até que eles expirem após 90 dias.
Como o faturamento é processado?
O faturamento da API Gemini é processado pelo sistema de faturamento do Cloud. Saiba mais sobre a configuração de faturamento no produto do Cloud Billing na documentação do Cloud Billing.
Sou cobrado por solicitações com falha?
Se a solicitação falhar com um erro 400 ou 500, não haverá cobrança pelos tokens usados. No entanto, a solicitação ainda será deduzida da sua cota.
O GetTokens é faturado?
As solicitações para a API GetTokens não são faturadas e não são contabilizadas na cota de inferência.
Como meus dados do Google AI Studio são tratados se eu tiver uma conta de API paga?
Consulte os Termos de Serviço para detalhes sobre como os dados são tratados quando o faturamento do Cloud está ativado (consulte "Como o Google usa seus dados" em "Serviços pagos"). Observe que os comandos do Google AI Studio são tratados de acordo com os mesmos termos de "Serviços pagos", desde que pelo menos um projeto de API tenha o faturamento ativado. Para verificar isso, acesse a página da chave de API Gemini e confira se há projetos marcados como "Pago" em "Plano".
O que acontece quando meu saldo de crédito pré-pago chega a R $0?
Todos os serviços da API Gemini em todos os projetos pagos por essa conta de pré-pagamento do Cloud Billing serão interrompidos imediatamente para evitar mais cobranças. Seus projetos não vão passar automaticamente para o nível sem custo financeiro.
Para restaurar o serviço no nível pago atual, compre mais créditos. Depois de comprar créditos, você poderá usar a API Gemini. Pode haver um atraso enquanto nossos sistemas são atualizados para refletir seu saldo de crédito.
Opcionalmente, para fazer downgrade para o nível sem custo financeiro, você pode desativar o faturamento nos projetos em que você quer fazer downgrade.
Meus créditos pré-pagos expiram?
Sim, os créditos expiram 12 meses após a data da compra.
Por que o saldo de crédito da minha conta pré-paga está negativo?
Devido à complexidade dos nossos sistemas de faturamento e processamento, pode haver atrasos na nossa capacidade de interromper o uso depois que você consumir todos os seus créditos. Esse uso em excesso pode aparecer como um saldo de crédito negativo no painel de faturamento do AI Studio. Se isso acontecer, o serviço será pausado, e o saldo negativo será deduzido da sua próxima compra de crédito.
Para evitar uma pausa no serviço da API Gemini, recomendamos configurar a recarga automática para comprar mais créditos automaticamente quando o saldo ficar abaixo de um valor especificado.
Posso usar meus créditos pré-pagos em outros serviços do Google Cloud, como a Vertex AI?
Não, os créditos pré-pagos são estritamente vinculados ao uso da API Gemini. Qualquer outro serviço do Google Cloud que você use (Compute, Storage, Vertex) será cobrado usando o ciclo de cobrança padrão do Cloud.
Por que aparece a mensagem "O tipo de conta de faturamento está inativo ou não é compatível"?
As interações de pagamentos na página de faturamento do AI Studio podem ser bloqueadas e substituídas pela mensagem "O tipo de conta de faturamento está inativo ou não é compatível" se o tipo ou status da conta de faturamento selecionada não for qualificado para o nível pago do AI Studio.
Verifique o Console do Cloud para conferir o status da sua conta de faturamento. Um tipo inelegível pode ser Conta de teste sem custo financeiro. Nesse caso, ative o faturamento no AI Studio para se qualificar. Um estado inativo pode ser Encerrado. Nesse caso, é possível reabrir a conta.
Onde posso receber ajuda com o faturamento?
Para receber ajuda com o faturamento, consulte Receber suporte do Cloud Billing.