Informations de facturation

Gérer la facturation par l’API

La section facturation de la Management API vous permet de consulter et mettre à jour vos informations de facturation, de récupérer vos factures et de contrôler vos dépenses — le tout de manière programmatique. Fini les allers-retours dans la console pour vérifier un statut de paiement.

Consulter les informations de facturation

Pour récupérer les informations de facturation de votre équipe :

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

La réponse contient les coordonnées de facturation enregistrées : nom de l’entreprise, adresse, pays, numéro de TVA le cas échéant.

Mettre à jour les informations

Pour modifier vos informations de facturation :

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/billing-info" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "companyName": "Mon Entreprise SAS",
    "address": "15 rue de la Paix",
    "city": "Paris",
    "country": "FR",
    "vatNumber": "FR12345678901"
  }'

Point important sur les factures existantes

Les informations de facturation mises à jour ne s’appliquent qu’aux futures factures. Il n’est pas possible de régénérer rétroactivement une facture avec de nouvelles coordonnées. Vérifiez donc vos informations avant la fin du cycle de facturation si vous avez besoin de factures correctes.

Consulter les factures

L’endpoint GET /v1/billing/teams/{teamId}/invoices retourne l’historique de vos factures :

# Factures d'un mois spécifique
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?billingCycle.year=2026&billingCycle.month=3" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

# Factures depuis un mois donné
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/invoices?since.year=2026&since.month=1" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Paramètres de filtrage

• billingCycle.year et billingCycle.month : récupérer les factures d’un cycle spécifique
• since.year et since.month : récupérer toutes les factures depuis un mois donné

Statuts des factures

Chaque facture possède un statut qui reflète son état de paiement :

• PENDING : la facture est en cours de traitement, le paiement n’a pas encore été prélevé
• PAID : le paiement a été effectué avec succès
• FAILED : le prélèvement a échoué (carte expirée, fonds insuffisants, etc.)
• WILL_NEVER_BE_CHARGED : la facture ne sera jamais facturée (crédit, ajustement)

Logique de facturation xAI

Le modèle de facturation xAI combine deux approches :

Crédits prépayés

Les crédits achetés sont facturés immédiatement au moment de l’achat. Chaque appel API consomme des crédits selon le nombre de tokens traités. Les crédits sont utilisés en priorité.

Facturation mensuelle (postpaid)

Si vos crédits sont épuisés ou si vous n’en avez pas, la consommation est facturée en fin de mois. Le coût de chaque appel API est calculé immédiatement, mais le prélèvement intervient à la fin du cycle.

Différence de comptage des tokens

Vous pourriez constater une différence entre le nombre de tokens compté par l’API et celui du tokenizer. C’est normal : les endpoints d’inférence ajoutent des tokens internes pour le traitement (instructions système, formatage), ce qui augmente légèrement le décompte facturé par rapport au texte brut.

Aperçu des charges en cours

Pour voir les charges accumulées avant la fin du cycle :

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Cet aperçu est précieux pour anticiper le montant de la prochaine facture et prendre des mesures si les coûts dépassent vos prévisions.

Points clés à retenir

• GET et POST sur /v1/billing/teams/{teamId}/billing-info pour consulter et modifier les infos
• Les factures ont 4 statuts : PENDING, PAID, FAILED, WILL_NEVER_BE_CHARGED
• Les modifications de facturation ne sont pas rétroactives sur les factures existantes
• xAI combine crédits prépayés (prioritaires) et facturation mensuelle
• L’aperçu des charges (invoice/preview) permet d’anticiper les coûts