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 em duas faixas de preços: o nível sem custo financeiro e o nível pago (pagamento por uso ou pague apenas pelo que usar). O nível sem custo financeiro está disponível para alguns modelos, que estão documentados na página Preços. Os preços e os limites de taxa variam entre os níveis e de acordo com o modelo.
O Google AI Studio também oferece uso sem custo financeiro até um limite para alguns modelos, separado do nível sem custo financeiro da API. Para acessar modelos e recursos pagos no AI Studio, vincule uma chave de API paga. É possível desvincular uma chave de API para voltar à cota sem custo financeiro de IA.
Por que usar o nível pago?
Ao fazer upgrade para o nível pago, você tem acesso a limites de taxa mais altos, usa modelos avançados e garante que seus comandos e respostas não sejam usados para melhorar os produtos do Google (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 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.
Cloud Billing
A API Gemini usa o Cloud Billing para serviços de faturamento, que podem ser configurados 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.
Perguntas frequentes
Esta seção traz respostas a 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.