Como obter a chave de API do Google Gemini
⚠️ Mesmo utilizando o Gemini Flash, que possui plano gratuito, é obrigatório ter um método de pagamento configurado na conta do Google Cloud. Sem isso, a chave de API não funcionará corretamente.
Para usar o Google Gemini como provedor de IA no Pingo Chat, é necessário gerar uma chave de API pelo Google AI Studio. O processo é simples e o Gemini oferece um plano gratuito com limite de requisições por minuto.
Passo 1 — Acessar o Google AI Studio
- Acesse aistudio.google.com
- Clique em Sign in e entre com sua conta Google.
- Aceite os Termos de Serviço da API do Google e os Termos Adicionais do Gemini.
Se for a primeira vez, o Google AI Studio criará automaticamente um projeto padrão para você.
Passo 2 — Gerar a chave de API
- No painel do Google AI Studio, clique em API Keys no menu lateral esquerdo.
- Clique no botão Create API key.
- Selecione um projeto existente ou crie um novo quando solicitado.
- A chave será gerada e exibida na tela.
- Copie a chave imediatamente e guarde em local seguro.
⚠️ Guarde a chave gerada em um local seguro. Embora seja possível visualizá-la novamente no painel, por segurança evite deixá-la exposta em locais públicos ou compartilhados.
Passo 3 — Configurar a chave no Pingo Chat
Com a chave copiada, acesse o Pingo Chat e siga o caminho abaixo:
- Acesse Automações → Agentes de IA.
- Clique no ícone de edição do agente desejado.
- Na aba Início, role a página até a seção Configuração de IA.
- Em Provedor de IA, selecione Google Gemini.
- Em Modelo, escolha o modelo desejado (ex: Gemini 1.5 Pro ou Gemini 1.5 Flash).
- No campo API Key, cole a chave gerada no Google AI Studio.
- Clique em Salvar agente.
Cada agente pode ter seu próprio provedor e modelo de IA configurados de forma independente. Você pode usar o Gemini em um agente e o GPT-4o em outro, conforme a necessidade.
Planos e limites do Gemini
O Google Gemini oferece dois planos de uso via API:
| Plano | Características |
|---|---|
| Gratuito (Free) | Limite de requisições por minuto e por dia. Sem custo, mas com restrições de volume. |
| Pago (Pay-as-you-go) | Sem limites rígidos de volume. Cobrado por tokens utilizados. Requer cartão de crédito no Google Cloud. |
Para operações de alto volume, como atendimentos simultâneos no WhatsApp, recomenda-se migrar para o plano pago. O consumo pode ser acompanhado em AI Studio → Usage and Limits.
Boas práticas de segurança
- Nunca compartilhe sua chave de API publicamente.
- Não insira a chave em repositórios de código abertos.
- Se suspeitar que a chave foi comprometida, acesse AI Studio → API Keys, delete a chave e gere uma nova.
- Crie chaves separadas para cada projeto ou integração para facilitar o controle e a revogação.