Crédits et facturation

L'API utilise les mêmes crédits que l'application : un seul solde par organisation, sans surcoût d'intégration.

Consulter le solde

Avec le scope credits:read, consultez à tout moment le solde de votre organisation :

GET /v1/credits
Authorization: Bearer bxk_…

{ "balance": 1234 }

Ce qui est facturé et ce qui ne l'est pas

Seule la génération coûte des crédits. Tout le reste — lecture, envoi du catalogue, export — est gratuit.

Opération	Facturation
`POST /v1/generations`	Facture au succès, par langue générée. Les langues en échec ne facturent pas.
`POST /v1/batches`	Réserve les crédits à l'envoi ; à l'ingestion du résultat, facture les succès et rembourse le reste.
`POST /v1/batches/{id}/cancel`	Rembourse la totalité de la réservation du lot.
`GET · PATCH · DELETE …`	Lectures, upserts, modifications et suppressions ne facturent pas.
`GET /v1/export/catalog.csv`	L'export ne facture pas : déjà payé à la génération.

Si le solde est insuffisant, la génération répond 402 AVANT de générer — jamais de travail à moitié ni de facturation partielle inattendue.

Mêmes prix que l'application

Générer via l'API coûte exactement le même prix que depuis l'application (les lots asynchrones sont moins chers que la génération synchrone, comme dans l'application). Le solde est partagé : ce que vous dépensez via l'API apparaît dans Crédits dans l'application, et inversement.

Le plafond de dépense quotidienne d'IA est aussi partagé avec l'application. Une fois atteint, la génération répond 429 sans en-tête Retry-After — réessayer ne sert à rien ; il se réinitialise le lendemain (UTC).

Acheter des crédits

Les crédits s'achètent depuis l'application, dans la section Crédits (l'API ne vend pas de crédits). L'achat requiert le rôle opérateur ou supérieur ; les clés d'API ne font que les consommer.