Costi, budget e analytics | Guida di Userbot

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

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

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

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.