Saldo en automatische opwaarderingen
Op deze pagina
Bewaken en automatiseren van opwaarderingen
Door het volgen van uw prepaid-saldo te combineren met gebruiksstatistieken, kunt u een slim opwaardeersysteem opzetten. In plaats van handmatig op te waarderen, automatiseert u het proces op basis van drempelwaarden en verbruiksprognoses.
Saldo-details controleren
Het eindpunt levert twee elementen die u niet mag verwarren: het directe saldo en de transactiegeschiedenis. Het eerste beantwoordt de vraag “Kan ik de API nog steeds aanroepen?”, het tweede beantwoordt “Hoe snel verbruik ik?”. Het tweede element stelt u in staat om vooruit te plannen en is daarom het enige waarop u automatisering kunt baseren.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Het antwoord bevat het huidige saldo en de transactiegeschiedenis (aankopen en verbruik).
Systeem voor automatische opwaardering
Een goed geconfigureerde automatische opwaardering steunt op twee cijfers, waarvan er één vaak wordt vergeten. De triggerdrempel moet uw verbruik tijdens de reactietijd dekken: als u eens per dag controleert, heeft u minimaal één dag krediet op voorhand nodig, anders wordt de automatisering pas geactiveerd nadat de limiet is bereikt. Het maandelijks maximum is de veiligheidsmaatregel die het vaakst ontbreekt; zonder dit kan een foutieve lus in uw applicatie de ene opwaardering na de andere activeren, en xAI-tegoed is niet restitueerbaar.
Deze twee waarden worden niet willekeurig ingesteld: de volgende sectie laat zien hoe u ze berekent op basis van uw daadwerkelijke verbruik.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Configuratie
MIN_BALANCE = 50.00 # Drempel voor opwaardering
TOP_UP_AMOUNT = 200.00 # Opwaardeerbedrag
MAX_MONTHLY = 1000.00 # Maandelijks maximum
def get_balance():
"""Haal het huidige prepaid-saldo op."""
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():
"""Bereken het totaal aan opwaarderingen voor de huidige maand."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filter transacties voor de huidige maand
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):
"""Voer een opwaardering uit."""
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
# Opwaardeerlogica
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"Opwaardering van ${TOP_UP_AMOUNT:.2f}. Geschat nieuw saldo: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Fout tijdens opwaardering")
else:
print(f"Maandelijks maximum bereikt (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Voldoende saldo: ${balance:.2f}")
Verbruiksprognose
Prognosticering transformeert monitoring in anticipatie. Een gemiddelde over zeven dagen volstaat voor de meeste use cases; dit geeft u een datum van uitputting, zodat u tijd heeft om in te grijpen. Pas echter op voor uw eigen verkeersseizoensgebondenheid: een gemiddelde berekend over een rustige week belooft een autonomie die verdwijnt zodra het verkeer toeneemt.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Verbruik over de laatste 7 dagen
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"}]
}
}
)
# Bereken het dagelijkse gemiddelde
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
# Schat de resterende dagen
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"Gemiddeld verbruik: ${avg_daily_cost:.2f}/dag")
print(f"Huidig saldo: ${current_balance:.2f}")
print(f"Geschatte uitputting: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dagen)")
Geïntegreerd volgdashboard
Het dashboard brengt samen wat drie verschillende eindpunten weten over uw kosten: het prepaid-saldo, de maandelijkse factureringskosten en de geconfigureerde limieten. Afzonderlijk vertelt elk een onvolledig verhaal; een comfortabel saldo zegt niets over het parallel lopende postpaid-verbruik. Het is de afstemming die de werkelijke kosten van de huidige maand oplevert.
#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="
# Prepaid-saldo
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 "Prepaid-saldo: \$${BALANCE}"
# Postpaid-kosten
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 "Postpaid-kosten: \$${POSTPAID}"
# Uitgavenlimiet
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 "Maandelijkse limiet: \$${LIMIT}"
Belangrijkste punten
- Automatiseer opwaarderingen met een minimumdrempel en een maandelijks maximum
- Gebruik analytics om data van kredietuitputting te voorspellen
- Combineer prepaid-saldo, postpaid-kosten en limieten in één unified dashboard
- Tegoed is niet restitueerbaar—kalibreer automatische opwaarderingen met voorzichtigheid
- Integreer deze scripts in uw cron-taken of CI/CD-pipeline