Gränser för utgifter
På denna sida
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
GETochPOSTpå/v1/billing/teams/{teamId}/postpaid/spending-limitsfö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)