Crediti e metering
betool addebita a consumo in crediti: 1 credito = $0,0001 (un decimillesimo di dollaro). Ricarichi il tuo saldo in anticipo; ogni esecuzione addebita il costo corrispondente.
Perché i crediti
Il sistema di crediti consente:
- Granularità fine — una chiamata API che costa $0,000003 è misurabile senza arrotondamenti.
- Stabilità dei prezzi — i tuoi prezzi unitari in crediti non cambiano quando un provider rivede le sue tariffe.
- Isolamento per organizzazione — ogni org ha il proprio saldo e i propri alert.
Cosa viene fatturato?
Consulta i dettagli in Prezzi. Riepilogo:
- LLM — per token di input / output. Incluso con BYOK (paghi direttamente il tuo provider; betool non prende nulla sui token).
- Voce — ASR al secondo, TTS al carattere.
- Minuti telefonici — in base al numero di destinazione.
- Operator HTTP / DB / transform — non soggetti a metering.
Ricaricare il saldo
Due modalità:
- Manuale — da Amministrazione → Fatturazione → Saldo, aggiungi un importo una tantum.
- Ricarica automatica — ricarica automatica quando il saldo scende sotto una soglia. Consigliata per evitare interruzioni del servizio.
Nel piano Enterprise, la fatturazione può passare al post-pagamento mensile con un impegno minimo.
Monitorare i consumi
Amministrazione → Fatturazione → Consumi:
- Saldo corrente
- Consumo su 7 giorni / 30 giorni / intervallo personalizzato
- Top 10 delle pipeline / agent più costosi
- Ripartizione per tipo di risorsa
La tabella è esportabile come CSV per l'integrazione con il tuo reporting interno.
Alert
Configura fino a 5 soglie di alert per organizzazione:
- Saldo basso — quando il saldo scende sotto X crediti, notifica Y (email, Mattermost, webhook).
- Picco di utilizzo — quando il consumo orario supera Z, avvisa immediatamente.
- Pipeline costosa — quando una pipeline specifica consuma più del previsto.
Rifiuto pre-chiamata
Se il tuo saldo è insufficiente per eseguire una chiamata LLM o una chiamata telefonica, betool rifiuta l'esecuzione prima di qualsiasi addebito. Vedrai un messaggio esplicito nella cronologia, e la pipeline viene contrassegnata out_of_credits.
Nessun sovrapprezzo è possibile: una chiamata non parte mai senza credito disponibile.
Per gli sviluppatori
Se stai chiamando l'API admin, l'endpoint /api/admin/billing/balance restituisce il tuo saldo e il limite di credito. Qualsiasi chiamante che cattura Exception deve rilanciare OutOfCreditsError per primo — è un segnale di fatturazione, non un errore di business.