Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Saldo og automatiske genopladninger

Lektion 11 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Overvåg og automatisér genopladninger
  2. Tjek saldoorienterede detaljer
  3. Automatisk genopladningssystem
  4. Forbrugsprognose
  5. Integreret overvågningsdashboard
  6. Vigtige pointer

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