Use a sua chave de API do Gemini num app, sem código

Como a API do Gemini difere do app Gemini

O Google entrega o Gemini de duas formas. O app Gemini, com o plano gratuito e os planos pagos Google AI, é um produto para consumidor. A API do Gemini é um produto para desenvolvedores: você cria uma chave de API, e um software — incluindo um app de chat que aceita a sua chave — envia solicitações aos modelos Gemini em seu nome.

A API é gerenciada no Google AI Studio e apoiada por um projeto do Google Cloud. A documentação do Google informa que toda chave de API do Gemini está associada a um projeto do Google Cloud, e que o projeto é onde ficam a cobrança, os colaboradores e as permissões. Os limites de taxa são aplicados por projeto, não por chave. O uso pago da API é ativado vinculando uma conta de cobrança do Cloud ao projeto, então não presuma que um plano Google AI de consumidor paga solicitações da API.

Passo 1: crie uma chave de API do Gemini

Criar uma chave leva um minuto e não exige cartão de crédito para a faixa gratuita. Se você é novo no AI Studio, ele cria um projeto padrão do Google Cloud e uma chave de API depois que você aceita os termos de serviço.

• Acesse aistudio.google.com/apikey e entre com a sua conta Google.
• Aceite os termos de serviço se pedirem; usuários novos recebem um projeto padrão e uma chave automaticamente.
• Crie uma chave de API, ou copie a que foi criada, e anote a qual projeto ela pertence.
• Guarde a chave em lugar seguro, como um gerenciador de senhas. Chaves do Gemini em geral começam com "AIza".

Passo 2: decida entre a faixa gratuita e a paga

Essa é a decisão que mais importa com o Gemini, porque as duas faixas diferem em mais que preço. A página de preços lista, para cada modelo, se a faixa gratuita é "Free of charge" ou "Not available", e também diz como o seu conteúdo é tratado em cada faixa.

Na faixa gratuita, a página de preços do Google diz que o conteúdo é usado para melhorar os produtos deles; na faixa paga, diz que o conteúdo não é usado para melhorar os produtos. Se você pretende colar algo pessoal ou confidencial, essa diferença é um motivo para vincular a cobrança mesmo se o seu uso coubesse nos limites gratuitos.

Os limites de taxa também diferem. Um projeto sem cobrança fica na faixa gratuita. Vincular uma conta de cobrança ativa o move para a Tier 1, e faixas maiores vêm do gasto acumulado com o tempo. Os limites variam por modelo, e o Google avisa que são exibidos no AI Studio e se atualizam automaticamente quando a sua faixa muda.

Quanto custa o Gemini na faixa paga

A tabela mostra os preços públicos da faixa paga do Google para três modelos atuais em 28 de setembro de 2026, para prompts de até 200.000 tokens, com um custo estimado para uma mensagem típica de 2.000 tokens de entrada e 600 de saída. Repare no preço com data do Gemini 3.8 Flash: o Google listava US$ 0,75 de entrada e US$ 3,75 de saída até 31 de dezembro de 2026, e US$ 1,50 de entrada e US$ 7,50 de saída a partir de 1º de janeiro de 2027.

Para o Gemini 3.8 Flash, a conta é 2.000 × US$ 0,75 / 1.000.000 + 600 × US$ 3,75 / 1.000.000 = US$ 0,00375 — menos de meio centavo. Conversas longas custam mais por mensagem porque os turnos anteriores são reenviados como entrada, e a fatura do Google é o valor final.

Passo 3: adicione a chave no Oriveo

O Oriveo é um app de chat multimodelo para iPhone, Android e web que usa as suas próprias chaves. O Google Gemini é um dos seus 15 provedores oficiais, em Direct AI Providers. Os rótulos abaixo são os que o app mostra em inglês.

Ao continuar, o Oriveo confere a chave perguntando ao Google quais modelos ela alcança, e sincroniza essa lista. Uma chave rejeitada pelo Google é reportada na hora, então dá para corrigir antes de conversar.

Passo 4: escolha um modelo e converse

Depois de conectar, os modelos Gemini aparecem no seletor de modelos. Os modelos Flash são rápidos e baratos e cobrem a maior parte do chat do dia a dia; os modelos Pro são para raciocínios mais difíceis e análises longas. Se a sua chave está na faixa gratuita, fique nos modelos que a página de preços marca como gratuitos, porque os modelos só pagos devolvem erro sem cobrança vinculada.

Dá para trocar para outro modelo no meio da conversa, inclusive um modelo de outro provedor conectado, e seguir na mesma conversa. Cada mensagem mostra um custo estimado pelo preço publicado do Google; na faixa gratuita, lembre que a cobrança real dos modelos gratuitos é zero e o limite é o de taxa.

Erros comuns e o que significam

Os erros do Gemini costumam ser específicos o bastante para apontar a causa.

• "chave de API not valid": a chave foi copiada incompleta, apagada ou restrita. Copie de novo no AI Studio ou crie outra.
• Limite de taxa ou recurso esgotado: você bateu no limite por minuto ou por dia do projeto para aquele modelo. Espere, troque de modelo, ou vincule a cobrança para limites maiores.
• Modelo não disponível na sua faixa: alguns modelos são só pagos. Vincule a cobrança ao projeto ou escolha um modelo gratuito.
• Várias chaves batendo nos limites juntos: os limites são por projeto, então chaves no mesmo projeto os compartilham.

Mantendo a sua chave segura

Uma chave do Gemini pode gastar dinheiro depois que a cobrança é vinculada, e pode consumir a sua cota gratuita até antes disso. O Oriveo guarda as chaves dos provedores no seu aparelho ou no seu navegador, em vez de como registros de conta. Os apps de iPhone e Android enviam as solicitações direto ao Google; o app web usa um endpoint de repasse em tempo real que não retém a chave nem o conteúdo dos chats BYOK. O Oriveo não sobretaxa os preços do Google.

Use um projeto ou chave dedicados para o app de chat, revise o uso no AI Studio e no console do Cloud, e apague qualquer chave que tenha sido exposta.