Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Udgiftsgrænser

Lektion 7 af 14 Opdateret 29. juli 2026 Udvikler
På denne side
  1. Styr dine API-omkostninger
  2. Se nuværende grænser
  3. Indstil grænser
  4. Se nuværende omkostninger
  5. Automatisér omkostningsovervågning
  6. Justér grænser dynamisk
  7. Vigtige pointer

Styr dine API-omkostninger

Udgiftsgrænser er dit økonomiske sikkerhedsnet. De sætter et loft, hvorefter API-anmodninger afvises, hvilket forhindrer uventede gebyrer ved månedens slutning. Management API’en giver dig mulighed for at se og indstille disse grænser programmatisk.

Se nuværende grænser

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

Svaret viser det aktuelle cyklusloft og dit nuværende forbrug – og dermed også din resterende margin ved fratrækning. Dette er det eneste tal, der betyder noget i hverdagen: et loft uden forbrugsdata fortæller dig ikke, om du har brugt 10 % eller 95 % af dit budget.

Indstil grænser

curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "monthlyLimit": 500.00
  }'

Adfærd ved overskridelse

Her kommer den beroligende del, og det er værd at sige det eksplicit: At ramme grænsen resulterer aldrig i overfakturering. Anmodninger afvises i stedet for at blive faktureret ud over loftet. Risikoen flyttes fra økonomi til tilgængelighed – hvilket er præcis, hvad du ønsker, fordi en nedetid diagnosticeres og løses på minutter, hvorimod en uventet regning opdages for sent.

Når forbruget når den fastsatte grænse:

  • API-anmodninger afvises med en specifik fejlkode
  • API-nøgler forbliver aktive, men inferenskald fejler
  • Grænsen nulstilles ved starten af den næste faktureringscyklus

Grænsestrategi efter miljø

For et team med flere projekter bør grænsen afspejle den risiko, der er specifik for hvert miljø. I udviklingsmiljøet er den typiske fare en utilsigtet anmodningsløkke – et testscript, der kører hele natten – og en lav grænse på 50 til 100 USD gør den fejl til en hændelse på 10 USD i stedet for en overraskelse på 1.000 USD. Staging håndterer belastningstests, som legitimt forbruger mere: en moderat grænse på 200 til 500 USD giver plads til testkampagner, mens der stadig holdes en sikkerhedsmargin. Produktion bør derimod aldrig begrænses så meget, at klientanmodninger afvises: en højere grænse (1.000 USD og derover, afhængigt af din trafik) kombineres med aktiv overvågning – alerten beskytter dig, mens grænsen blot er sikkerhedsnettet i sidste instans.

Se nuværende omkostninger

For at se, hvor du står i den aktuelle cyklus:

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

Dette endpoint returnerer omkostninger akkumuleret siden starten af cyklusset. Sammenlignet med antallet af dage, der er gået, giver det dig mere end et øjebliksbillede: det giver en prognose. At forbruge 40 % af budgettet, når en tredjedel af måneden er gået, er sundt; de samme 40 % ved en tiendedel af måneden signalerer en overskridelse, og du har stadig syvogtyve dage til at handle.

Automatisér omkostningsovervågning

Script til tærskelalert

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Alert ved 80% af grænsen

# Hent grænsen
limits_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/spending-limits",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
monthly_limit = limits_resp.json().get("monthlyLimit", 0)

# Hent nuværende forbrug
preview_resp = requests.get(
    f"{MANAGEMENT_API}/v1/billing/teams/{TEAM_ID}/postpaid/invoice/preview",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_spend = preview_resp.json().get("totalAmount", 0)

# Tjek tærskel
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"ALERT: {ratio*100:.1f}% af grænsen nået")
        print(f"  Forbrug: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Send notifikation

Integration med overvågning

Kombinér forhåndsvisningen af omkostninger med din overvågningsløsning (Grafana, Datadog osv.) for at skabe dashboards til omkostninger i realtid:

# Hent aktuelt beløb til sending til dit metrics-system
CURRENT_SPEND=$(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', 0))")

echo "xai.billing.current_spend:$CURRENT_SPEND|g" | nc -u -w1 localhost 8125

Justér grænser dynamisk

Grænsen er ikke mejslet i sten for faktureringscyklusset – og det er en god ting, fordi produktlivscyklusser ikke følger den regnskabsmæssige kalender. Før en forventet trafikspids, produktlancering eller marketingkampagne bør du midlertidigt øge grænsen: intet er værre end en betalt kampagne, der sender brugere til en tjeneste, hvis API afviser anmodninger på grund af et nået loft. Omvendt, hvis månedens budget allerede er brugt hurtigere end forventet, vil en sænkning af grænsen for resten af cyklusset omdanne afdrift til en kontrolleret begrænsning. Det mest kritiske tilfælde forbliver en omkostningshændelse – en løkke i produktion, opdaget misbrug: at sænke grænsen øjeblikkeligt er din nødstopsknap, den der stopper blødningen, mens du finder årsagen.

# Midlertidig forhøjelse til en lancering
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 2000.00}'

# Nulstil normal grænse efter spidsen
curl -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"monthlyLimit": 500.00}'

Vigtige pointer

  • Brug GET og POST på /v1/billing/teams/{teamId}/postpaid/spending-limits til at se og indstille grænser
  • Når grænsen overskrides, afvises API-anmodninger (ingen overfakturering)
  • Forhåndsvisning af omkostninger (invoice/preview) lader dig spore forbrug i realtid
  • Automatisér tærskelalerts for at forudse overskridelser
  • Tilpas grænser efter miljø (dev, staging, produktion)