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

Gränser för utgifter

Lektion 7 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Kontrollera dina API-kostnader
  2. Visa aktuella gränser
  3. Ställ in gränser
  4. Visa aktuella avgifter
  5. Automatisera kostnadsövervakning
  6. Justera gränser dynamiskt
  7. Viktiga punkter

Kontrollera dina API-kostnader

Gränser för utgifter är ditt ekonomiska skyddsnät. De sätter ett tak bortom vilket API-förfrågningar nekas, vilket förhindrar oväntade avgifter i slutet av månaden. Med Management API kan du visa och ställa in dessa gränser programmatiskt.

Visa aktuella gränser

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

Svaret visar taket för den aktuella cykeln och din nuvarande förbrukning – och därmed, genom differensen, din återstående marginal. Detta är det enda tal som spelar roll i det dagliga arbetet: ett tak utan förbrukningsdata berättar inte om du har använt 10 % eller 95 % av din budget.

Ställ in 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
  }'

Beteende vid överskridande

Här kommer den lugnande delen, och det är värt att säga det explicit: att nå gränsen leder aldrig till överfakturering. Förfrågningar nekas, de debiteras inte utöver taket. Risken flyttas från ekonomi till tillgänglighet – vilket är exakt vad du vill ha, eftersom ett driftstopp diagnostiseras och åtgärdas på minuter, medan en oväntad faktura upptäcks för sent.

När förbrukningen når den inställda gränsen:

  • API-förfrågningar nekas med en specifik felkod
  • API-nycklar förblir aktiva men inferensanrop misslyckas
  • Gränsen återställs vid starten av nästa faktureringscykel

Gränsstrategi per miljö

För ett team med flera projekt bör gränsen spegla risken som är specifik för varje miljö. I utvecklingsmiljön är den typiska faran en oavsiktlig ögla av förfrågningar – ett testskript som körs hela natten – och en låg gräns på 50 till 100 USD gör det felet till en incident på 10 USD snarare än en överraskning på 1 000 USD. Staging-miljön hanterar lasttester, vilket legitimt konsumerar mer: en måttlig gräns på 200 till 500 USD lämnar utrymme för testkampanjer samtidigt som en skyddsräcke finns kvar. Produktionen bör dock aldrig strypas så mycket att klientförfrågningar nekas: en högre gräns (1 000 USD och uppåt, beroende på din trafik) kombineras med aktiv övervakning – aviseringen skyddar dig, medan gränsen bara är säkerhetsnätet i sista utväg.

Visa aktuella avgifter

För att se var du står i den aktuella cykeln:

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

Denna endpoint returnerar avgifter som ackumulerats sedan cykelns start. Jämfört med antalet dagar som har passerat ger detta dig mer än en ögonblicksbild: en prognos. Att förbruka 40 % av budgeten när en tredjedel av månaden har gått är hälsosamt; samma 40 % vid en tiondel av månaden signalerar en överskridning, och du har fortfarande tjugosju dagar på dig att agera.

Automatisera kostnadsövervakning

Skript för tröskelavisering

import requests

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80  # Avisera vid 80% av gränsen

# Hämta 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)

# Hämta aktuell förbrukning
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)

# Kontrollera tröskel
if monthly_limit > 0:
    ratio = current_spend / monthly_limit
    if ratio >= ALERT_THRESHOLD:
        print(f"ALERT: {ratio*100:.1f}% of limit reached")
        print(f"  Spend: ${current_spend:.2f} / ${monthly_limit:.2f}")
        # Skicka avisering

Integration med övervakning

Kombinera förhandsvisningen av avgifter med din övervakningslösning (Grafana, Datadog, etc.) för att skapa kostnadsdashboards i realtid:

# Hämta aktuellt belopp för att skicka till ditt metrikssystem
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

Justera gränser dynamiskt

Gränsen är inte huggen i sten för faktureringscykeln – och det är bra, eftersom produktlivscykeln inte följer den redovisningsmässiga kalendern. Innan en förväntad trafiktopp, produktlansering eller marknadsföringskampanj, öka gränsen tillfälligt: inget är värre än en betald kampanj som skickar användare till en tjänst vars API nekar förfrågningar på grund av ett nått tak. Omvänt, om månadens budget redan har förbrukats snabbare än väntat, gör att sänka gränsen för resten av cykeln gör att avdrift blir en kontrollerad begränsning. Det mest kritiska fallet är fortfarande en kostnadsincident – en ögla i produktion, upptäckt missbruk: att sänka gränsen omedelbart är din nödstopp, den som stoppar blödningen medan du hittar orsaken.

# Öka tillfälligt inför en lansering
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}'

# Återställ normal gräns efter toppen
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}'

Viktiga punkter

  • Använd GET och POST på /v1/billing/teams/{teamId}/postpaid/spending-limits för att visa och ställa in gränser
  • När gränsen överskrids nekas API-förfrågningar (ingen överfakturering)
  • Förhandsvisning av avgifter (invoice/preview) låter dig spåra förbrukning i realtid
  • Automatisera aviseringar vid tröskelvärden för att förutse överskridanden
  • Anpassa gränser efter miljö (utveckling, staging, produktion)