Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Forudbetalte credits

Lektion 8 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. xAIs forudbetalte model
  2. Tjek din saldo
  3. Køb credits (genopfyldning)
  4. Strategier for credit-forbrug
  5. Overvågning af saldo
  6. Vigtige pointer

xAIs forudbetalte model

Forudbetalte credits giver dig mulighed for at købe en saldo på forhånd, som bliver brugt, efterhånden som du foretager API-kald. Denne model er ideel til at kontrollere udgifterne: du bruger kun det, du har købt, uden ubehagelige overraskelser ved månedens slutning. Credits bruges før den månedlige fakturering.

Tjek din saldo

Forudbetaling vender risikoforholdet på hovedet sammenlignet med månedlig fakturering. Ved efterbetaling finder du først beløbet ud ved månedens slutning; ved forudbetaling sættes loftet på forhånd, og worst-case-scenariet er serviceafbrydelse – ubehageligt, men begrænset. For et team, der udforsker API’et, eller et projekt med et fast budget, er dette det rigtige kompromis.

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

Svaret indeholder:

  • Den nuværende saldo i dollars
  • Historik for genopfyldning med datoer og beløb
  • Forbrugshistorik pr. periode

Køb credits (genopfyldning)

Sådan genopfylder du din credits-saldo:

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
  }'

Vigtige pointer om credits

De fire punkter nedenfor har konkrete konsekvenser for, hvordan du automatiserer. Det andet punkt er særligt vigtigt: credits kan ikke refunderes. Dette alene udelukker strategien med et enkelt stort køb “for en sikkerheds skyld”. Beskedne, hyppige genopfyldninger er bedre, selvom du automatiserer dem, end kapital bundet i et projekt, der måske skifter retning.

  • Credits trækkes straks ved køb på din standardbetalingsmetode
  • Forudbetalte credits er ikke-refunderbare (medmindre det er lovpligtigt i din jurisdiktion)
  • Credits forbruges prioriteret før den månedlige efterbetalingsfakturering
  • Der er ingen udløbsdato angivet for credits – de forbliver tilgængelige, indtil de er brugt

Faktureringsflow med credits

Det er værd at kende forbrugsrækkefølgen, før du konfigurerer noget, da det afgør, hvad dine dashboards viser. Credits kommer først, den månedlige fakturering overtager bagefter: Med andre ord betyder en forudbetalt saldo, der stagnerer på nul, mens alt fungerer, at du allerede er skiftet til efterbetaling uden at vide det.

  1. Forudbetalte credits tilgængelige: tokens trækkes fra den forudbetalte saldo
  2. Credits opbrugt: forbruget skifter til månedlig fakturering (efterbetaling)
  3. Udgiftsloft nået: anmodninger afvises

Strategier for credit-forbrug

Fast månedligt budget

Dette er strategien med det hårde budget: Uden aktiveret månedlig fakturering stopper opbrugte credits kaldene i stedet for at generere gæld. Acceptér kompromiset – servicen afbrydes, og det er bedre, at dette er et eksplicit valg end en opdagelse en fredag aften. Kombinér det med alarmen ved lav saldo, som beskrives senere.

import requests
from datetime import datetime

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

# Tjek 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)

# Genopfyld hvis saldoen er lav
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"Genopfyldt ${top_up_amount:.2f}")

Projekttilvejebringelse

Projekttilvejebringelse har en fordel udover regnskabet: saldoen bliver et mål for fremdrift. Hvis halvdelen af credits er brugt, mens kun en fjerdedel af arbejdet er udført, får du informationen før tidspunktet, hvor det er for sent, så der stadig er tid til at beslutte, om omfanget skal reduceres, eller modeller skal skiftes.

# Projektbudget: $500 over 3 måneder
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}'

Overvåg derefter forbruget via analytics (næste lektion) for at sikre, at budgettet overholdes.

Overvågning af saldo

Alarm ved lav 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 "ALARM: Lav forudbetalt saldo ($BALANCE $)"
    # Send en notifikation
fi

Dashboard for forbrug

Kombinér den forudbetalte saldo med forhåndsvisningen af efterbetalingsomkostninger for at få et komplet overblik over dine omkostninger:

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

# Nuværende efterbetalingsomkostninger
echo "=== Efterbetalingsomkostninger ==="
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

Vigtige pointer

  • GET /v1/billing/teams/{teamId}/prepaid/balance returnerer saldoen og historikken
  • POST /v1/billing/teams/{teamId}/prepaid/top-up køber credits (trækkes straks)
  • Forudbetalte credits er ikke-refunderbare
  • Credits forbruges før den månedlige fakturering
  • Automatisér genopfyldninger med en minimumstærskel for at undgå afbrydelser
  • Kombinér forudbetalte credits og udgiftslofter for total omkostningskontrol