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 automatizada 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 plano pago e atender aos critérios para uma mudança de plano, acesse a página Chaves de API do AI Studio e selecione Fazer upgrade na coluna Nível de cota da linha de chave-projeto em que ela está disponível.
O sistema vai verificar automaticamente se o projeto atende aos requisitos. Se o projeto atender a todos os requisitos, ele será atualizado instantaneamente para o próximo nível.
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 pode ser faturado imediatamente.
- Ação necessária: envie um pré-pagamento único que se aplique ao uso da sua conta.
Verificação única de pré-pagamento
O Google pode exigir um pré-pagamento único para ativar o nível pago da API Gemini. Essa medida ajuda a manter a segurança e a disponibilidade da nossa plataforma para todos os usuários. Não é uma taxa, mas sim um crédito aplicado diretamente à sua conta para uso futuro.
Processo de pré-pagamento
- Configurar o faturamento: quando você ativa a API Gemini em um projeto vinculado a uma conta de faturamento qualificada, avisamos se é necessário fazer um pré-pagamento.
- Receber notificações: depois de configurar a conta de faturamento, você vai receber uma caixa de diálogo no AI Studio e um e-mail informando sobre o requisito.
- Fazer um pagamento : na página "Chaves de API", clique em Ação necessária em Nível de cota para a chave recém-vinculada.
- Fazer upgrade: depois que o pagamento for processado (o que é instantâneo para a maioria das formas de pagamento), seu projeto vai fazer upgrade para o nível pago, e os novos limites de taxa serão aplicados.
Cloud Billing
A API Gemini usa o Cloud Billing para serviços de faturamento, que podem ser configurados diretamente no AI Studio. Depois de ativar o Cloud Billing, use as ferramentas dele para monitorar gastos, entender custos, fazer pagamentos e acessar o suporte.
Novos usuários recebem imediatamente uma conta do Cloud Billing paga do Google Cloud e US $300 em créditos de boas-vindas.
Usuários atuais que já têm uma conta paga ou de teste sem custos financeiros do Cloud Billing do Google podem selecionar uma conta do Cloud Billing no AI Studio sem acessar o console do Google Cloud. Os usuários atuais não recebem créditos de boas-vindas de US $300.
Leia mais sobre a configuração de faturamento automatizado do Cloud.
Monitorar o uso
Depois de ativar o Cloud Billing, você pode monitorar o uso da API Gemini no Google AI Studio em Painel > Uso e limites.
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 mais cota, siga as instruções em Fazer upgrade para o próximo nível pago.
Posso usar a API Gemini sem custo financeiro 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 custo financeiro, 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 projetos 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 meus créditos do Google Cloud com a API Gemini?
Sim, os créditos do Google Cloud podem ser usados para o uso da API Gemini.
Como o faturamento é processado?
O faturamento da API Gemini é processado pelo sistema do Cloud Billing. 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.
Há uma cobrança para ajustar os modelos?
O ajuste de modelos não é mais compatível com a API Gemini ou o AIS.
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".
O que acontece com minha pré-venda?
O valor total é adicionado como crédito à sua conta do Cloud Billing. Esse crédito será usado automaticamente para pagar pelo uso no Google Cloud, incluindo a API Gemini ou outros serviços, como o Compute Engine e o Cloud Storage. Isso não afeta seus créditos do teste sem custo financeiro.
E se eu não fizer o pré-pagamento?
Sem problemas. Seu projeto vai continuar no nível sem custo financeiro da API Gemini. Você não vai perder o acesso, mas estará sujeito aos limites de taxa do nível sem custo financeiro. Você pode concluir o pré-pagamento a qualquer momento no futuro para fazer upgrade.
Posso receber um reembolso da minha pré-compra?
Sim. Se você tiver um saldo de crédito na sua conta, poderá pedir um reembolso no Cloud Console, sujeito às nossas políticas de reembolso padrão.
O pré-pagamento afeta meu crédito de teste sem custo financeiro de US $300?
Não. Isso é diferente dos créditos do teste sem custo financeiro. Você ainda pode usar os créditos do teste sem custo financeiro em produtos qualificados.
O que acontece se eu gastar mais do que o valor pré-pago?
Quando o saldo de crédito pré-pago acabar, sua conta vai passar para o faturamento padrão. Qualquer uso adicional será cobrado na forma de pagamento principal vinculada à sua conta do Cloud Billing.
Onde posso receber ajuda com o faturamento?
Para receber ajuda com o faturamento, consulte Receber suporte do Cloud Billing.