Saldo og automatiske genopladninger
På denne side
Overvåg og automatisér genopladninger
Ved at kombinere sporing af forudbetalt saldo med brugsanalytik kan du opsætte et intelligent genopladningssystem. I stedet for at genoplade manuelt kan du automatisere processen baseret på tærskler og forbrugsprognoser.
Tjek saldoorienterede detaljer
Endpointet returnerer to ting, du ikke må forveksle: den øjeblikkelige saldo og transaktionshistorikken. Den første svarer på „Kan jeg stadig kalde API’et?”, mens den anden svarer på „Hvor hurtigt bruger jeg?”. Det er den anden, der giver dig mulighed for at se frem i tiden, og derfor er det den eneste, du kan basere automatisering på.
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Svaret indeholder den aktuelle saldo og transaktionshistorikken (køb og forbrug).
Automatisk genopladningssystem
Et velkonfigureret automatisk genopladningssystem hviler på to tal, hvoraf det ene ofte glemmes. Udløser-tærsklen skal dække dit forbrug i reaktionstiden: Hvis du tjekker én gang om dagen, skal du have mindst én dags kredit på forhånd; ellers vil automatiseringen udløses efter cutoff-tidspunktet. Det månedlige loft er den sikkerhedsforanstaltning, der oftest mangler – uden den kan en fejlsløjfe i din applikation udløse genopladning efter genopladning, og xAI-kreditter refunderes ikke.
Disse to værdier fastsættes ikke vilkårligt: Næste afsnit viser, hvordan du beregner dem baseret på dit faktiske forbrug.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Konfiguration
MIN_BALANCE = 50.00 # Tærskel for genopladning
TOP_UP_AMOUNT = 200.00 # Genopladningsbeløb
MAX_MONTHLY = 1000.00 # Månedligt loft
def get_balance():
"""Hent den aktuelle forudbetalte saldo."""
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():
"""Beregn de samlede genopladninger for den aktuelle måned."""
resp = requests.get(
f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
# Filtrér transaktioner for den aktuelle måned
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):
"""Udfør en genopladning."""
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
# Logik for genopladning
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"Genopladning på ${TOP_UP_AMOUNT:.2f}. Estimeret ny saldo: ${balance + TOP_UP_AMOUNT:.2f}")
else:
print("Fejl under genopladning")
else:
print(f"Månedligt loft nået (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
print(f"Tilstrækkelig saldo: ${balance:.2f}")
Forbrugsprognose
Prognoser omdanner overvågning til forventning. Et syv-dages gennemsnit er nok til de fleste brugstilfælde; det giver dig en udløbsdato, så du har tid til at handle. Vær dog opmærksom på din egen trafik-sæsonbestemthed – et gennemsnit beregnet over en stille uge lover en autonomi, der forsvinder, så snart trafikken tager fart.
import requests
from datetime import datetime, timedelta
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Forbrug over de sidste 7 dage
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"}]
}
}
)
# Beregn dagligt gennemsnit
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 resterende dage
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"Gennemsnitligt forbrug: ${avg_daily_cost:.2f}/dag")
print(f"Aktuel saldo: ${current_balance:.2f}")
print(f"Estimeret udløb: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dage)")
Integreret overvågningsdashboard
Dashboardet samler det, som tre forskellige endpoints ved om dine omkostninger: den forudbetalte saldo, månedlige faktureringsgebyrer og konfigurerede grænser. Adskilt fortæller hver enkelt en ufuldstændig historie – en komfortabel saldo siger intet om efterbetalingsforbrug, der kører parallelt. Det er afstemningen, der giver den sande omkostning for den aktuelle måned.
#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="
# Forudbetalt 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 "Forudbetalt saldo: \$${BALANCE}"
# Efterbetalingsgebyrer
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 "Efterbetalingsgebyrer: \$${POSTPAID}"
# Forbrugsgrænse
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 "Månedlig grænse: \$${LIMIT}"
Vigtige pointer
- Automatisér genopladninger med en minimumstærskel og et månedligt loft
- Brug analytik til at forudsige datoer for kreditudløb
- Kombinér forudbetalt saldo, efterbetalingsgebyrer og grænser i ét samlet dashboard
- Kreditter refunderes ikke – kalibrér automatiske genopladninger med forsigtighed
- Integrér disse scripts i din cron eller CI/CD-pipeline