> ## 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.

# Configurar API Key

> Como obter e configurar sua API Key do Google Gemini para o agente de IA.

# Configurar API Key do Google Gemini

O Brainchat usa sua própria API Key do Google para chamar os modelos Gemini. Isso significa que você paga o custo de tokens diretamente ao Google, sem intermediários.

## Obter a API Key

<Steps>
  <Step title="Acesse o Google AI Studio">
    Vá para [aistudio.google.com](https://aistudio.google.com) e faça login com sua conta Google.
  </Step>

  <Step title="Crie uma API Key">
    Clique em **Get API Key** → **Create API Key**. Selecione ou crie um projeto do Google Cloud.
  </Step>

  <Step title="Copie a chave">
    A chave terá o formato `AIza...`. Copie e guarde em local seguro.

    <Warning>
      Nunca compartilhe sua API Key publicamente. Ela dá acesso à sua conta do Google AI.
    </Warning>
  </Step>
</Steps>

## Configurar no Brainchat

1. No dashboard, acesse **Instância → Agente de IA**
2. Cole a API Key no campo **Chave da API Google**
3. Clique em **Salvar**

<Info>
  A chave é armazenada de forma criptografada no Brainchat. Nem a equipe da plataforma tem acesso ao valor em texto puro.
</Info>

## Custos

O Google cobra por uso (tokens processados). Para referência:

* **1.000 conversas curtas** (10 mensagens cada) ≈ \$0.50 com Gemini 2.0 Flash
* **1.000 conversas longas** (30 mensagens cada) ≈ \$2.00 com Gemini 2.0 Flash

Monitore seu uso no [console do Google Cloud](https://console.cloud.google.com).

## Solução de Problemas

| Erro                | Causa                      | Solução                              |
| ------------------- | -------------------------- | ------------------------------------ |
| `API key not valid` | Chave inválida ou expirada | Gere uma nova chave no AI Studio     |
| `Quota exceeded`    | Limite de uso atingido     | Aumente cota no Google Cloud Console |
| `Model not found`   | Modelo não disponível      | Troque para um modelo suportado      |