> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brainchat.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Chave do Google

> Como criar a chave da API do Google Gemini e usar no agente de IA.

O agente de atendimento usa uma chave da API do Google Gemini da sua organização. O uso dos modelos é cobrado pelo Google direto nessa chave e **não** desconta [créditos de IA](https://docs.brainchat.app/organizacao/creditos-ia.md).

## Criar a chave no Google

**1. Abra o Google AI Studio**

Acesse [aistudio.google.com](https://aistudio.google.com) com a conta Google da empresa.

**2. Crie a chave**

Clique em **Get API Key** → **Create API Key** e escolha (ou crie) um projeto.

**3. Copie**

A chave começa com `AIza...`. Guarde em lugar seguro e não compartilhe.

## Usar no Brainchat

![Aba Suas Chaves com a lista de chaves da organização e o botão Adicionar chave](https://mintcdn.com/stegia/Lm99ll5VN1TwpclF/images/developers/suas-chaves.png?fit=max\&auto=format\&n=Lm99ll5VN1TwpclF\&q=85\&s=92b952b10a7d68487192596900db57ef)

Developers → API → Suas Chaves (valores borrados)

1. Cadastre a chave em **Developers → API → Suas Chaves** (ou pelo **+** no seletor de chave do agente).
2. No construtor do agente, aba **API & Modelo**, escolha a chave em **Chave da API Google Gemini**.
3. Clique em **Testar conexão**. A mensagem **Conexão estabelecida!** confirma.

A chave fica guardada no cofre do canal, criptografada, e pode ser usada por vários agentes.

## Problemas comuns

| Mensagem do Google | Causa | O que fazer |
| - | - | - |
| `API key not valid` | Chave errada, apagada ou expirada | Gere uma chave nova e troque no agente |
| `Quota exceeded` | Limite de uso do projeto atingido | Aumente a cota ou ative o faturamento no projeto do Google |
| `Model not found` | Modelo indisponível para a chave | Escolha outro modelo na lista |

Acompanhe o gasto da chave no console do Google Cloud.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.