API de gestion : gestion des clés et de la facturation
Pe această pagină
Gérez votre compte sans la console
L’API de gestion xAI est une interface REST dédiée à la administration de votre compte Entreprise. Là où l’API d’inférence (api.x.ai) appelle les modèles, l’API de gestion (management-api.x.ai) administre vos ressources. La distinction peut sembler mineure. Elle ne l’est pas. Tout ce qui nécessiterait autrement qu’une personne ouvre la console web et clique devient ici automatisable — traçable, reproductible et intégrable aux outils que vos équipes utilisent déjà.
Provisionner et faire tourner les clés
La création de clés via l’API vous permet d’automatiser le provisionnement pour une nouvelle application ou un nouvel environnement :
curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "cle-production-chatbot",
"acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
"qps": 10,
"qpm": 100,
"tpm": 1000000,
"expireTime": "2026-12-31T23:59:59Z"
}'
Les paramètres de cette requête définissent entièrement la portée de la clé :
- name : Identifiant lisible par l’homme pour la clé
- acls : Liste des permissions (points de terminaison et modèles autorisés)
- qps/qpm/tpm : Limites de débit par seconde, par minute et tokens par minute
- expireTime : Date d’expiration automatique
Définir expireTime lors de la création est l’habitude qui vous évitera le plus de problèmes à long terme : une clé émise pour un pilote de trois mois expirera d’elle-même au lieu de survivre indéfiniment dans un fichier de configuration que personne ne lit plus.
La rotation régulière des clés suit la même hygiène de sécurité. Le point de terminaison dédié génère une nouvelle clé secrète et invalide l’ancienne :
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Avertissement : l’ancienne clé secrète est invalidée immédiatement et définitivement. Préparez-vous à déployer la nouvelle valeur dans votre gestionnaire de secrets avant d’exécuter la commande, jamais après. Trois points de terminaison en lecture seule complètent l’ensemble : GET /auth/teams/{teamId}/api-keys liste toutes les clés de l’équipe, GET /auth/api-keys/{apiKeyId}/propagation vérifie que la clé est propagée sur tous les nœuds, et GET /auth/teams/{teamId}/models liste les modèles accessibles avec leurs tarifs. Le second est celui que vous consultez juste après une rotation, lorsqu’une application renvoie encore des erreurs d’authentification et que vous ignorez s’il s’agit d’un bug applicatif ou simplement d’un délai de propagation.
Suivre et contrôler la facturation
La récupération des informations de facturation utilise un point de terminaison dédié :
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Vous récupérez l’historique des factures avec un filtrage par période, ici pour mars 2026 :
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Chaque facture possède un statut parmi PENDING, PAID, FAILED et WILL_NEVER_BE_CHARGED. Mettre en surface un statut FAILED dans votre surveillance est bien préférable à l’apprentissage de l’incident via une interruption de service un lundi matin.
Pour éviter les dépassements budgétaires, configurez un plafond mensuel :
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 5000}'
Si vous opérez en prépayé, vérifiez le solde de la même manière :
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Rappelez-vous que les crédits prépayés sont non remboursables, sauf obligation légale. Dimensionnez vos achats en fonction de la consommation observée sur plusieurs semaines, et non sur des projections de croissance optimistes.
Surveillez votre consommation avec la bonne granularité
Le point de terminaison d’analytique vous permet de suivre l’utilisation avec une fine granularité :
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}'
Cette requête renvoie la consommation quotidienne de tokens, ventilée par modèle, pour le mois de mars. En changeant timeUnit, vous passez d’une vue mensuelle à une vue par minute : les valeurs possibles sont MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR et MINUTE. Les agrégations vont bien au-delà des simples totaux, avec SUM, AVG, MIN, MAX, P50, P90, P99 et COUNT. Les percentiles caractérisent efficacement la charge car les moyennes lissent précisément les pics qui déterminent la capacité dont vous avez réellement besoin.
L’API de gestion prend alors sa place dans votre chaîne d’outils. Vous provisionnez des clés depuis Terraform ou Pulumi comme une base de données, votre pipeline CI/CD crée des clés éphémères pour les environnements de test puis les supprime à la fin de l’exécution, des scripts de surveillance alertent avant d’atteindre le plafond de dépenses, et vos tableaux de bord internes affichent la consommation sans qu’un humain n’exporte un CSV chaque lundi.
Puncte cheie
- L’API de gestion sur management-api.x.ai gère les clés, la facturation et les métriques
- La rotation des clés invalide définitivement l’ancienne clé secrète
- Les limites de dépenses protègent contre les dépassements budgétaires
- Les analytiques d’utilisation offrent une granularité de la minute au mois
- Intégrez l’API de gestion dans vos outils d’infrastructure pour automatiser l’administration