Crédits & metering
betool facture à l'usage en crédits : 1 crédit = $0.0001 (un dix-millième de dollar). Vous rechargez votre solde à l'avance ; chaque exécution débite le coût correspondant.
Pourquoi des crédits
Le système de crédits permet :
- Une granularité fine — un appel API à $0.000003 est métrable sans arrondi.
- Une stabilité de prix — vos prix unitaires en crédits ne changent pas quand un provider revoit son tarif.
- Un découpage par organisation — chaque org a son propre solde, ses propres alertes.
Que paye-t-on ?
Voir le détail dans Tarifs. Résumé :
- LLM — par tokens entrée / sortie. Inclus en BYOK (vous payez votre provider directement, betool ne prend rien sur les tokens).
- Voix — ASR par seconde, TTS par caractère.
- Minutes téléphone — selon la destination du numéro.
- Opérateurs HTTP / DB / transform — non métrés.
Recharger son solde
Deux modes :
- Manuel — depuis Administration → Facturation → Solde, ajouter un montant ponctuellement.
- Auto-recharge — recharge automatique quand le solde passe sous un seuil. Conseillé pour éviter les coupures.
Sur le plan Enterprise, la facturation peut basculer en post-paiement mensuel avec engagement minimum.
Suivre la consommation
Administration → Facturation → Consommation :
- Solde courant
- Consommation 7 jours / 30 jours / personnalisé
- Top 10 des pipelines / agents les plus coûteux
- Répartition par type de ressource
Le tableau est exportable en CSV pour intégration à votre suivi interne.
Alertes
Configurez jusqu'à 5 seuils d'alerte par organisation :
- Seuil bas — quand le solde passe sous X crédits, prévenir Y (email, Mattermost, webhook).
- Pic d'usage — quand la consommation horaire dépasse Z, alerter immédiatement.
- Pipeline coûteux — quand un pipeline particulier consomme plus que prévu.
Refus pre-call
Si votre solde est insuffisant pour exécuter un LLM call ou un appel téléphonique, betool refuse l'exécution avant tout débit. Vous voyez un message explicite dans l'historique, et le pipeline est marqué out_of_credits.
Aucune surfacturation possible : un appel ne démarre jamais sans crédit disponible.
Pour les développeurs
Si vous appelez l'API admin, l'endpoint /api/admin/billing/balance renvoie votre solde et votre limite de crédit. Tout caller qui catch Exception doit re-raise OutOfCreditsError en premier — c'est un signal de billing, pas une erreur métier.