Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Saldo och automatiska påfyllningar

Lektion 11 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Övervaka och automatisera påfyllningar
  2. Kontrollera saldot detaljerat
  3. System för automatisk påfyllning
  4. Prognos för förbrukning
  5. Integrerad översiktsdashboard
  6. Viktiga punkter

Övervaka och automatisera påfyllningar

Genom att kombinera spårning av förbetalt saldo med användningsanalys kan du sätta upp ett smart system för påfyllning. Istället för att fylla på manuellt kan du automatisera processen baserat på tröskelvärden och prognoser för förbrukningen.

Kontrollera saldot detaljerat

Slutpunkten returnerar två saker du inte får förväxla: det omedelbara saldot och transaktionshistoriken. Den första svarar på frågan “Kan jag fortfarande anropa API:et?”, medan den andra svarar på “Hur snabbt förbrukar jag?”. Det är den andra som låter dig vara proaktiv, och därmed den enda du kan basera automatisering på.

curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Svaret innehåller aktuellt saldo samt transaktionshistorik (inköp och förbrukning).

System för automatisk påfyllning

Ett välkonfigurerat system för automatisk påfyllning förlitar sig på två siffror, där den ena ofta glöms bort. Tröskelvärdet för utlösning måste täcka din förbrukning under reaktionstiden: om du kontrollerar en gång om dagen behöver du minst en dags kredit i förväg, annars utlöses automatiseringen efter att gränsen passerats. Den månadsvisa taket är den säkerhetsåtgärd som oftast saknas—utan den kan en felaktig loop i ditt applikation utlösa påfyllning efter påfyllning, och xAI-krediter återbetalas inte.

Dessa två värden sätts inte godtyckligt: nästa avsnitt visar hur du beräknar dem baserat på din faktiska förbrukning.

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      # Tröskel för påfyllning
TOP_UP_AMOUNT = 200.00   # Belopp vid påfyllning
MAX_MONTHLY = 1000.00    # Månadsvis tak

def get_balance():
    """Hämta aktuellt förbetalt 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():
    """Beräkna totala påfyllningar för innevarande månad."""
    resp = requests.get(
        f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
        headers={"Authorization": f"Bearer {MGMT_KEY}"}
    )
    # Filtrera transaktioner för innevarande månad
    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):
    """Utför en påfyllning."""
    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 för påfyllning
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"Påfyllning på ${TOP_UP_AMOUNT:.2f}. Beräknat nytt saldo: ${balance + TOP_UP_AMOUNT:.2f}")
        else:
            print("Fel vid påfyllning")
    else:
        print(f"Månadsvis tak nått (${monthly_spent:.2f} / ${MAX_MONTHLY:.2f})")
else:
    print(f"Tillräckligt saldo: ${balance:.2f}")

Prognos för förbrukning

Prognostisering omvandlar övervakning till framförhållning. Ett snitt över sju dagar räcker för de flesta användningsfall; det ger dig ett datum för när krediterna tar slut, så att du hinner agera. Var dock försiktig med säsongssvängningar i din egen trafik—ett snitt beräknat över en lugn vecka lovar en autonomi som försvinner så fort trafiken ökar.

import requests
from datetime import datetime, timedelta

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Förbrukning under de senaste 7 dagarna
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"}]
        }
    }
)

# Beräkna dagsnitt
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

# Uppskatta återstående dagar
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"Genomsnittlig förbrukning: ${avg_daily_cost:.2f}/dag")
    print(f"Aktuellt saldo: ${current_balance:.2f}")
    print(f"Beräknad tömning: {exhaustion_date.strftime('%m/%d/%Y')} ({days_remaining:.0f} dagar)")

Integrerad översiktsdashboard

Dashboarden sammanför vad tre olika slutpunkter vet om dina kostnader: det förbetalda saldot, månadsvisa faktureringsavgifter och konfigurerade gränser. Åtskilda berättar var och en en ofullständig historia—ett bekvämt saldo säger ingenting om efterhandsförbrukning som löper parallellt. Det är avstämningen som ger den sanna kostnaden för innevarande månad.

#!/bin/bash
echo "=== xAI Dashboard - $(date '+%m/%d/%Y %H:%M') ==="

# Förbetalt 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 "Förbetalt saldo: \$${BALANCE}"

# Efterhandsavgifter
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 "Efterhandsavgifter: \$${POSTPAID}"

# Utgiftstak
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ånadsvis gräns: \$${LIMIT}"

Viktiga punkter

  • Automatisera påfyllningar med ett minimitröskelvärde och ett månadsvis tak
  • Använd analysverktyg för att prognostisera datum då krediter tar slut
  • Kombinera förbetalt saldo, efterhandsavgifter och gränser i en enhetlig dashboard
  • Krediter återbetalas inte—kalibrera automatiska påfyllningar med försiktighet
  • Integrera dessa skript i din cron eller CI/CD-pipeline