# Chaves de API dos modelos

Os modelos de linguagem são pagos no provedor deles por uma **chave de API**. O
draften guarda chaves em três níveis, e o assistente usa a mais próxima.

## Três níveis

| Nível | Onde | Quem gerencia |
|---|---|---|
| caixa de e-mail | a página da caixa de e-mail → Chaves de API da caixa de e-mail | o proprietário da caixa de e-mail |
| organização | Organização → Chaves de API da organização | os proprietários e administradores da organização |
| operador (padrão) | Instalação → Chaves de API padrão | o operador do draften |

Um assistente sem escolha própria usa a **chave herdada**: a chave ativa mais
próxima da API padrão – primeiro a da caixa de e-mail, depois a da organização,
depois a do operador. Em Configurações → **Modelos e chaves** do assistente, é
possível escolher uma chave e um modelo específicos por etapa (triagem, escrita,
aprendizado).

## Provedores

- **Anthropic** (padrão) – console.anthropic.com → API Keys.
- **OpenAI** – as instruções foram calibradas em modelos Claude; antes de mudar
  para a OpenAI, teste no conjunto de teste. Com dados sensíveis, confira as
  condições de retenção de dados da OpenAI.
- **Compatível com a OpenAI (modelo local)** – Ollama, LM Studio, llama.cpp,
  vLLM e similares. Os e-mails então nunca saem do seu servidor. Só o operador
  pode informar uma chave assim (ela traz o endereço do servidor); organizações e
  caixas de e-mail a herdam.

## Adicionar uma chave

Escolha a API, informe um **nome** (“conta Anthropic da empresa”, por exemplo) e
a **chave** (inteira, `sk-…`). A chave é guardada criptografada e nunca mais é
exibida – a lista mostra só o final dela. Uma chave pode ser **desativada**,
**ativada** e **apagada**; uma chave que um assistente usa nas configurações dele
não pode ser apagada (altere-a lá primeiro ou apenas desative a chave).

Para guardar chaves, o servidor precisa ter `MASTER_KEY` definido.

## Custos

Recomendamos definir um limite mensal de gastos diretamente no provedor (no
console, no caso da Anthropic), caso algo entre em ciclo. No draften, cada
assistente também tem um limite diário de custo – veja
[Custos e limites](/pt/admin/cost-and-caps).