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

Förbetalda krediter

Lektion 8 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. xAIs förbetalda modell
  2. Kontrollera ditt saldo
  3. Köp krediter (fyll på)
  4. Strategier för kreditanvändning
  5. Övervakning av saldo
  6. Viktiga punkter

xAIs förbetalda modell

Med förbetalda krediter köper du ett saldo i förväg som förbrukas när du gör API-anrop. Denna modell är idealisk för att kontrollera kostnaderna: du spenderar bara det du har köpt, utan några överraskningar i slutet av månaden. Krediter används före den månatliga faktureringen.

Kontrollera ditt saldo

Förbetalda krediter vänder på riskprofilen jämfört med månadsfakturering. Vid efterbetalning upptäcker du kostnaden först i efterhand; vid förbetalning sätts taket i förväg och värsta tänkbara scenario är att tjänsten avbryts – obehagligt, men begränsat. För ett team som utforskar API:et eller ett projekt med en fast budget är detta rätt avvägning.

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

Svaret innehåller:

  • Det aktuella saldot i dollar
  • Påfyllnadshistoriken med datum och belopp
  • Användningshistoriken per period

Köp krediter (fyll på)

För att fylla på ditt kreditkonto:

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.00
  }'

Viktiga punkter om krediter

De fyra punkterna nedan har konkreta konsekvenser för hur du automatiserar. Den andra är särskilt viktig: krediter är icke-återbetalningsbara. Detta ensamt utesluter strategin att göra ett enda stort inköp “för säkerhets skull”. Små, frekventa påfyllningar är bättre, även om du automatiserar dem, än kapital som binds i ett projekt som kan ändra inriktning.

  • Krediter debiteras omedelbart vid köp på din standardbetalningsmetod
  • Förbetalda krediter är icke-återbetalningsbara (såvida inte lagen i din jurisdiktion kräver annat)
  • Krediter förbrukas i första hand före den månatliga efterbetalningen
  • Det finns inget angivet utgångsdatum för krediter – de finns tillgängliga tills de är förbrukade

Faktureringsflöde med krediter

Det är värt att känna till förbrukningsordningen innan du konfigurerar något, eftersom det avgör vad dina instrumentpaneler visar. Krediter går först, månadsfakturering tar över därefter: med andra ord, om ett förbetalt saldo ligger stilla på noll medan allt fungerar, har du redan bytt till efterbetalning utan att inse det.

  1. Förbetalda krediter tillgängliga: token dras från det förbetalda saldot
  2. Krediter slut: förbrukningen växlar till månadsfakturering (efterbetalning)
  3. Spenderingsgräns nådd: begäranden nekas

Strategier för kreditanvändning

Fast månadsbudget

Detta är strategin med hård budget: utan aktiverad månadsfakturering stoppar uttömda krediter anropen istället för att skapa skuld. Acceptera avvägningen – tjänsten avbryts, och det är bättre att detta är ett explicit val än en upptäckt en fredagskväll. Kombinera detta med larmet för lågt saldo som beskrivs senare.

import requests
from datetime import datetime

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

# Kontrollera saldo
balance_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/prepaid/balance",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
balance = balance_resp.json().get("balance", 0)

# Fyll på om saldot är lågt
MONTHLY_BUDGET = 200.00
RECHARGE_THRESHOLD = 50.00

if balance < RECHARGE_THRESHOLD:
    top_up_amount = MONTHLY_BUDGET - balance
    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": top_up_amount}
    )
    print(f"Fyllde på ${top_up_amount:.2f}")

Projektallokering

Projektallokering har en fördel utöver redovisningen: saldot blir ett mått på framdriften. Om hälften av krediterna är förbrukade medan bara en fjärdedel av arbetet är klart, får du den informationen i tid, när det fortfarande finns möjlighet att besluta om att minska omfattningen eller byta modeller.

# Projektbudget: $500 över 3 månader
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/top-up" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount": 500.00}'

Övervaka sedan användningen via analysverktyg (nästa lektion) för att säkerställa att budgeten respekteras.

Övervakning av saldo

Larm vid lågt saldo

#!/bin/bash
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', 0))")

THRESHOLD=20.00
if (( $(echo "$BALANCE < $THRESHOLD" | bc -l) )); then
    echo "ALERT: lågt förbetalt saldo ($BALANCE $)"
    # Skicka en notifiering
fi

Instrumentpanel för användning

Kombinera det förbetalda saldot med en förhandsvisning av efterbetalda avgifter för en komplett bild av dina kostnader:

# Förbetalt saldo
echo "=== Förbetalda krediter ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/prepaid/balance" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

# Nuvarande efterbetalda avgifter
echo "=== Efterbetalda avgifter ==="
curl -s "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Viktiga punkter

  • GET /v1/billing/teams/{teamId}/prepaid/balance returnerar saldo och historik
  • POST /v1/billing/teams/{teamId}/prepaid/top-up köper krediter (debiteras omedelbart)
  • Förbetalda krediter är icke-återbetalningsbara
  • Krediter förbrukas före månadsfakturering
  • Automatisera påfyllningar med en minimigräns för att undvika avbrott
  • Kombinera förbetalda krediter och spenderingsgränser för total kostnadskontroll