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) | Inscrição | N/A |
| Nível 1 | 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 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 para mudar para os níveis pagos. Você vai passar para níveis mais altos com base no gasto acumulado e na idade da conta. É possível desvincular chaves de API individuais para retornar essa chave à cota sem custo financeiro do AI Studio.
* Privacidade de dados de nível empresarial: para mais informações sobre o uso de dados em 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 diretamente no Google AI Studio sem mudar para o console do Google Cloud. Você vai ganhar o status faturável imediato sem custos iniciais e pagar depois apenas pelos recursos específicos que consumir durante o ciclo de faturamento. Leia a configuração de faturamento automatizado do Cloud para mais informações.
- Acesse a página Chaves de API do AI Studio ou qualquer lugar em que você veja "Configurar faturamento" no AI Studio.
- Os novos usuários terão um projeto e uma chave de API criados para eles por padrão.
- Se você precisar de uma nova chave, clique em Criar chave de API e siga as instruções da caixa de diálogo para adicionar um par chave-projeto à tabela.
- Encontre o projeto que você quer fazer upgrade para o nível pago e clique em Configurar faturamento na coluna Nível de cota.
- Se um projeto já estiver em um nível pago, talvez apareça a opção de Fazer upgrade.
- A configuração é diferente para usuários novos e atuais do Cloud Billing:
Novos usuários
Este fluxo de trabalho é para usuários que não têm contas de faturamento do Google.
- Siga as etapas para escolher seu projeto e a chave de API para configuração.
- Selecione seu país para concordar com os Termos de Serviço na janela Configurar sua conta de faturamento do Google Cloud.
- Se você tiver perfis para pagamentos vinculados à sua conta, as Informações de contato e a Forma de pagamento vão aparecer preenchidas na janela Adicionar detalhes da conta de faturamento. Clique em Mudar para editar qualquer um dos campos.
- Se você não tiver um perfil para pagamentos, clique no botão + para Informações de contato e Forma de pagamento e siga as instruções para preencher seus detalhes nas respectivas janelas.
- Clique em Concluir a configuração da conta.
- A próxima janela vai informar seu status de faturamento.
Usuários existentes
Este fluxo de trabalho é para usuários que já configuraram o faturamento do Google com a conta.
- Siga as etapas para escolher seu projeto e a chave de API para configuração.
- Você terá várias opções na janela Configurar sua conta do Cloud Billing:
- Se você tiver várias contas de faturamento, clique no menu Selecionar conta de faturamento para escolher aquela que quer vincular ao projeto selecionado.
- Se você tiver apenas uma conta de faturamento, ela será selecionada automaticamente no menu.
- Se você não quiser usar nenhuma das suas contas atuais, clique em Adicionar nova conta de faturamento no menu. Isso vai acionar a etapa 3 na seção Novos usuários do Cloud Billing.
- Clique em Concluir configuração.
- A próxima janela vai informar seu status de faturamento.
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, o upgrade para o próximo nível será feito automaticamente.
Verificar o status de faturamento
Depois de configurar o faturamento para o nível pago, você vai saber imediatamente se a configuração foi concluída. Você também pode verificar se o projeto do Google Cloud está vinculado à conta do Cloud Billing e pronto para uso pago na página "Chaves de API". O status de faturamento da sua chave na coluna Nível de cota pode mostrar:
- Nível 1, 2 ou 3: verifica se o projeto está vinculado e imediatamente faturável.
- Ação necessária: você precisa realizar uma ação na sua conta, como pagar uma fatura, atualizar uma forma de pagamento etc.
Monitorar o uso
É possível monitorar o uso da API Gemini no Google AI Studio em Painel > Uso.
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 no nível do 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 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ê mudar um projeto para outra conta de faturamento, o limite de gastos que já tiver definido para ele 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 gasto mensal:
| 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. Quando o total cumulativo atinge o limite do nível, o serviço é suspenso para todos os projetos dessa conta até o início do próximo ciclo de faturamento (mensal).
, mas a interface deles vai ficar visível no AI Studio antes para que os usuários tenham tempo de se ajustar.Vale lembrar que um pequeno número de usuários será afetado quando isso entrar em vigor. Se o gasto atual for maior que o limite do novo nível, você vai receber uma notificação por e-mail com mais detalhes. Leia Avaliar o gasto da sua conta de faturamento para mais informações.
Avaliar o gasto 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:
- Acesse a página Gerenciamento da conta de faturamento no console do Cloud.
- O painel Visão geral da conta de faturamento mostra Seu custo total no mês atual. Clique em Ver detalhes nos relatórios na parte de baixo dessa janela.
- 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.
- Ajuste o filtro Período por data de uso para o intervalo desejado e avalie seu gasto histórico em um período.
Cloud Billing
A API Gemini usa o Cloud Billing para contas de faturamento, que podem ser configuradas diretamente no AI Studio. Use o AI Studio para acompanhar os gastos e entender os custos. Você pode acessar as mesmas informações e fazer pagamentos na sua conta do Cloud Billing.
Projetos e chaves de API
É possível criar até 10 projetos em uma conta de faturamento, e um projeto pode vincular até 5 chaves de API.
Os níveis de uso são aplicados no nível da conta de faturamento. Todos os projetos em uma conta de faturamento herdam o nível de cota e os limites associados. O gasto cumulativo e a idade da conta em todos os projetos vinculados a uma conta de faturamento contam para as qualificações do nível.
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?
É possível conferir sua cota e os limites do sistema no AI Studio ou no console do Google Cloud.
Como solicitar mais cota?
Para solicitar um aumento no limite de taxa de um nível pago, use este formulário.
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 de pagamento por uso
- Com planos sem custos financeiros para modelos selecionados
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 inelegível, 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 automatizada do faturamento 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"). As solicitações do Google AI Studio são tratadas 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".
Onde posso receber ajuda com o faturamento?
Para receber ajuda com o faturamento, consulte Receber suporte do Cloud Billing.