> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.userbot.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server.

# Costi, budget e analytics

Ogni chiamata all'API viene contabilizzata subito: si paga in base ai token
usati, e la spesa compare nei consumi dell'area di lavoro. Questa pagina spiega
chi paga, cosa ferma le chiamate e dove leggere i numeri.

## Come si calcola il costo

Il costo di una chiamata è il numero di token in ingresso e in uscita
moltiplicato per il listino del modello. I listini sono quelli pubblici dei
fornitori, in dollari: li leggi in `GET /models` e nelle colonne **Input
USD/1M** e **Output USD/1M** della scheda **I modelli disponibili**, nella pagina
**Sviluppatore**. La spesa invece è mostrata in euro, convertita al cambio del
giorno.

Il numero di token di ogni chiamata è nel campo `usage` della risposta. Gli
embedding si pagano solo sui token in ingresso.

## Chi paga

Dipende dalla chiave usata.

| Chiave                         | Da dove si scala                                                                                                                                                                                        |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Chiave dell'area di lavoro** | Dal credito prepagato (il wallet) dell'area di lavoro, per intero. Non tocca l'utilizzo incluso di nessun membro                                                                                        |
| **Chiave personale**           | Dall'utilizzo di chi la possiede, esattamente come la sua chat: prima l'utilizzo incluso nel suo piano, poi, se l'area di lavoro ha attivato l'utilizzo extra, il credito prepagato entro il suo budget |

Con una chiave personale, quindi, uno script pesante consuma lo stesso utilizzo
che serve a quella persona per lavorare in chat. Per un'integrazione che gira da
sola conviene una chiave dell'area di lavoro.

## Quando le chiamate si fermano

In chat, quando l'utilizzo finisce, le risposte passano a un modello più
economico. Via API no: la chiamata viene rifiutata, con un codice che dice il
motivo.

| Risposta | `code`                   | Cosa vuol dire                                                                                                              | Chi lo risolve                                                                      |
| -------- | ------------------------ | --------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| `402`    | `wallet_insufficient`    | Il credito prepagato dell'area di lavoro è a zero                                                                           | Un amministratore, ricaricando in **Fatturazione**                                  |
| `402`    | `fair_use_exceeded`      | Chi possiede la chiave personale ha finito l'utilizzo incluso della sessione o della settimana, e l'utilizzo extra è spento | Aspetta che la finestra si azzeri, oppure un amministratore attiva l'utilizzo extra |
| `402`    |                          | Il periodo di prova è finito                                                                                                | Un amministratore, attivando l'abbonamento                                          |
| `429`    | `member_budget_exceeded` | Chi possiede la chiave personale ha raggiunto il suo budget                                                                 | Un amministratore, alzando il budget, oppure aspetti il reset                       |
| `429`    | `api_budget_exceeded`    | L'area di lavoro ha raggiunto il suo tetto di spesa mensile                                                                 | Un amministratore, alzando il tetto, oppure aspetti il mese successivo              |

Un `429` senza `code` è un'altra cosa: è il limite di frequenza, e passa da solo
in meno di un minuto. → [Limiti e quote](/api-limiti)

Se il credito o il budget finiscono mentre una risposta in streaming è in corso,
il flusso si interrompe con un evento di errore.

> **Info**
>
> Per un'integrazione che deve restare accesa, la difesa vera contro un blocco a
> notte fonda è la ricarica automatica del credito, che chi amministra attiva in
> **Fatturazione**. → [Limiti di spesa e credito](/spesa)

## Dove si controlla la spesa

**Le tue chiavi.** Nella pagina **Sviluppatore**, la scheda **Il tuo utilizzo**
mostra la spesa delle tue chiavi personali nel mese, le richieste e i token, divisi
per fornitore, per modello e per chiave, e quanto hai usato del tuo budget.

**Tutta l'area di lavoro.** Chi amministra ha due schede in **Impostazioni ›
Funzionalità › Chiavi API**:

* **Costo e budget**: il credito disponibile, quanto è stato speso nel periodo, il
  tetto mensile e le richieste, divise fra completamenti ed embedding. Qui si
  cambiano il tetto dell'area di lavoro e il budget di ogni membro, e **Scarica
  CSV** esporta una riga per ogni chiamata del periodo, con chiave, modello,
  token e costo;
* **Analytics**: la spesa e le richieste nel periodo che scegli (**Questo mese**,
  **Mese scorso**, **Ultimi 7 giorni**, **Ultimi 30 giorni** o
  **Personalizzato**), separate fra **Chiavi workspace** e **Chiavi personali**,
  con il dettaglio per fornitore, per modello e per membro. Si aggiornano dopo
  ogni chiamata.

Come si impostano tetto e budget è spiegato in [Chiavi API dell'area di lavoro](/chiavi-api-admin).