Aller au contenu principal

Informations de facturation

Mis à jour le 29 juillet 2026

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.

GET
Consulter
POST
Mettre à jour
4
Statuts de facture
Mensuel
Cycle de facturation

Consulter les informations de facturation

Les coordonnées de facturation paraissent anodines jusqu’au jour où la comptabilité refuse une facture au mauvais nom ou sans numéro de TVA. Les vérifier par l’API prend une requête et évite une correction impossible : comme le rappelle l’encadré plus bas, aucune facture déjà émise ne peut être régénérée avec de nouvelles coordonnées.

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

Parmi ces quatre statuts, un seul demande une action immédiate. FAILED signifie que le prélèvement n’est pas passé — carte expirée, plafond atteint, opposition — et une facture impayée finit par entraîner la suspension du service. C’est le statut qu’il faut surveiller automatiquement, comme le montre la leçon sur les moyens de paiement ; les trois autres se consultent, celui-ci s’alerte.

  • 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

Comprendre l’articulation entre les deux modes évite des interprétations fausses de vos propres tableaux de bord. Les crédits prépayés partent en premier ; la facturation mensuelle ne prend le relais qu’une fois le solde épuisé. Un solde à zéro avec un service qui fonctionne toujours n’est donc pas une anomalie : c’est le signe que vous consommez désormais en postpaid, et que la facture de fin de mois s’alimente.

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

Un écart entre votre comptage local et celui de la facturation est attendu, et il vaut mieux le savoir avant de passer une demi-journée à le traquer. La facturation fait foi : calez vos estimations de coût sur les chiffres de l’API d’analytics, jamais sur un comptage effectué avec un tokenizer côté client. 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 le seul moyen de connaître le montant en cours avant l’émission de la facture. Consulté une fois par semaine, il transforme la facturation mensuelle en quelque chose de pilotable : vous voyez la dérive à mi-parcours, quand il est encore temps de router du trafic vers un modèle moins cher ou d’abaisser une limite.

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
← Lecon precedenteRotation et suppression de clésLecon suivante →Moyens de paiement