Udgiftsgrænser
På denne side
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
GETogPOSTpå/v1/billing/teams/{teamId}/postpaid/spending-limitstil 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)