Solde et rechargements automatiques
Ar an leathanach seo
Surveiller et automatiser les rechargements
Combiner le suivi du solde prépayé avec les analyses d’utilisation te permet de mettre en place un système de rechargement intelligent. Au lieu de recharger manuellement, tu peux automatiser le processus en fonction de seuils et de prévisions de consommation.
Vérifier les détails du solde
Le point de terminaison renvoie deux éléments qu’il ne faut pas confondre : le solde instantané et l’historique des transactions. Le premier répond à « Puis-je encore appeler l’API ? », le second à « À quelle vitesse est-ce que je consomme ? ». C’est le second qui te permet d’anticiper, et donc le seul sur lequel tu peux baser l’automatisation.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
La réponse contient le solde actuel et l’historique des transactions (achats et consommation).
Système de rechargement automatique
Un rechargement automatique bien configuré repose sur deux chiffres, dont l’un est souvent oublié. Le seuil de déclenchement doit couvrir ta consommation pendant le temps de réaction : si tu vérifies une fois par jour, tu as besoin d’au moins un jour de crédit d’avance, sinon l’automatisation se déclenchera après la coupure. Le plafond mensuel est la sauvegarde qui manque le plus souvent : sans lui, une boucle défectueuse dans ton application peut déclencher rechargement sur rechargement, et les crédits xAI ne sont pas remboursables.
Ces deux valeurs ne sont pas fixées arbitrairement : la section suivante montre comment les calculer en fonction de ta consommation réelle.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Configuration
MIN_BALANCE = 50.00 # Seuil de rechargement
TOP_UP_AMOUNT = 200.00 # Montant du rechargement
MAX_MONTHLY = 1000.00 # Plafond mensuel
def get_balance():
"""Obtenir le solde prépayé actuel."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
return resp.json().get("balance", 0)
def get_monthly_top_ups():
"""Calculer le total des rechargements pour le mois en cours."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtrer les transactions pour le mois en cours
transactions = resp.json().get("transactions", [])
current_month = datetime.now().strftime("%Y-%m")
monthly_total = sum(
t.get("amount", 0)
for t in transactions
if t.get("type") == "top-up" and t.get("date", "").startswith(current_month)
)
return monthly_total
def top_up(amount):
"""Effectuer un rechargement."""
resp = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/top-up",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={"amount": amount}
)
return resp.status_code == 200
# Logique de rechargement
balance = get_balance()
monthly_spent = get_monthly_top_ups()
if balance < MIN_BALANCE:
remaining_budget = MAX_MONTHLY - monthly_spent
if remaining_budget >= TOP_UP_AMOUNT:
if top_up(TOP_UP_AMOUNT):
print(f"Rechargement de ${TOP_UP_AMOUNT:.2f}. Nouveau solde estimé : ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Erreur lors du rechargement")
else:
print(f"Plafond mensuel atteint (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Solde suffisant : ${balance:.2f}")
Prévision de la consommation
La prévision transforme la surveillance en anticipation. Une moyenne sur sept jours suffit pour la plupart des cas d’usage ; elle te donne une date d’épuisement, ce qui te laisse le temps d’agir. Méfie-toi cependant de la saisonnalité de ton propre trafic : une moyenne calculée sur une semaine creuse promet une autonomie qui disparaîtra dès que le trafic reprendra.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Consommation sur les 7 derniers jours
end = datetime.now()
start = end - timedelta(days=7)
usage_resp = requests.post(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/usage",
headers={
"Authorization": f"Bearer {MGMT_KEY}",
"Content-Type": "application/json"
},
json={
"analyticsRequest": {
"timeRange": {
"startTime": start.strftime("%Y-%m-%d %H:%M:%S"),
"endTime": end.strftime("%Y-%m-%d %H:%M:%S"),
"timezone": "Europe/Paris"
},
"timeUnit": "DAY",
"values": [{"name": "cost", "aggregation": "SUM"}]
}
}
)
# Calculer la moyenne quotidienne
data_points = usage_resp.json().get("dataPoints", [])
daily_costs = [p.get("value", 0) for p in data_points]
avg_daily_cost = sum(daily_costs) / len(daily_costs) if daily_costs else 0
# Estimer les jours restants
balance_resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_balance = balance_resp.json().get("balance", 0)
if avg_daily_cost > 0:
days_remaining = current_balance / avg_daily_cost
exhaustion_date = datetime.now() + timedelta(days=days_remaining)
print(f"Consommation moyenne : ${avg_daily_cost:.2f}/jour")
print(f"Solde actuel : ${current_balance:.2f}")
print(f"Épuisement estimé : {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} jours)")
Tableau de bord de suivi intégré
Le tableau de bord rassemble ce que trois points de terminaison différents savent de tes coûts : le solde prépayé, les facturations mensuelles et les limites configurées. Séparément, chacun raconte une histoire incomplète : un solde confortable ne dit rien de la consommation postpayée qui s’exécute en parallèle. C’est la réconciliation qui donne le coût réel du mois en cours.
#!/bin/bash
echo "=== Tableau de bord xAI - $(date '+%m/%d/%Y %H:%M') ==="
# Solde prépayé
BALANCE=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('balance', 'N/A'))")
echo "Solde prépayé : \$${BALANCE}"
# Frais postpayés
POSTPAID=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('totalAmount', 'N/A'))")
echo "Frais postpayés : \$${POSTPAID}"
# Limite de dépenses
LIMIT=$(curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -c "import sys,json; print(json.load(sys.stdin).get('monthlyLimit', 'N/A'))")
echo "Limite mensuelle : \$${LIMIT}"
Príomhphointí
- Automatise les rechargements avec un seuil minimum et un plafond mensuel
- Utilise les analyses pour prévoir les dates d’épuisement du crédit
- Combine solde prépayé, frais postpayés et limites dans un tableau de bord unifié
- Les crédits ne sont pas remboursables : calibre les rechargements automatiques avec prudence
- Intègre ces scripts dans ton cron ou ta pipeline CI/CD