# Chiavi API dei modelli

I modelli linguistici si pagano presso il loro fornitore tramite una **chiave
API**. draften tiene le chiavi su tre livelli e l’assistente prende quella più
vicina.

## Tre livelli

| Livello | Dove | Chi la gestisce |
|---|---|---|
| casella | la pagina della casella → Chiavi API della casella | il proprietario della casella |
| organizzazione | Organizzazione → Chiavi API dell’organizzazione | i proprietari e i gestori dell’organizzazione |
| operatore (predefinito) | Installazione → Chiavi API predefinite | l’operatore di draften |

Un assistente senza una scelta propria usa la **chiave ereditata**: la chiave
attiva più vicina dell’API predefinita – prima quella della casella, poi quella
dell’organizzazione, poi quella dell’operatore. Nelle Impostazioni
dell’assistente → **Modelli e chiavi** si possono scegliere una chiave e un
modello specifici per ogni lavoro (smistamento, scrittura, apprendimento).

## Fornitori

- **Anthropic** (predefinito) – console.anthropic.com → API Keys.
- **OpenAI** – le istruzioni sono state ottimizzate sui modelli Claude; prima
  di passare a OpenAI, provalo sul set di prova. Con dati sensibili, controlla
  le condizioni di conservazione dei dati di OpenAI.
- **Compatibile con OpenAI (modello locale)** – Ollama, LM Studio, llama.cpp,
  vLLM e simili. In questo caso la posta non lascia mai il tuo server. Solo
  l’operatore può inserire una chiave di questo tipo (contiene l’indirizzo del
  server); organizzazioni e caselle la ereditano.

## Aggiungere una chiave

Scegli l’API, compila **Nome** (per esempio “account Anthropic aziendale”) e
**Chiave** (quella intera, `sk-…`). La chiave viene salvata cifrata e non viene
più mostrata – l’elenco ne mostra solo la parte finale. Una chiave si può
disattivare (**Disattiva**), riattivare (**Attiva**) ed eliminare
(**Elimina**); una chiave che un assistente indica nelle sue impostazioni non
si può eliminare (cambiala prima lì, oppure disattiva semplicemente la chiave).

Per salvare le chiavi il server deve avere impostata la `MASTER_KEY`.

## Costi

Ti consigliamo di impostare un limite di spesa mensile direttamente presso il
fornitore (per Anthropic nella console), nel caso qualcosa finisca in un ciclo.
In draften ogni assistente ha anche un limite di spesa giornaliero – vedi
[Costi e limiti](/it/admin/cost-and-caps).
