Uitgavenlimieten
Op deze pagina
Beheer uw API-kosten
Uitgavenlimieten vormen uw financiële veiligheidsnet. Ze stellen een maximumbedrag vast waarboven API-verzoeken worden geweigerd, waardoor onverwachte kosten aan het einde van de maand worden voorkomen. Met de Management API kunt u deze limieten programmatisch bekijken en instellen.
Huidige limieten bekijken
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Het antwoord toont het plafond voor de huidige cyclus en uw huidige verbruik; het verschil geeft uw resterende marge aan. Dit is het enige cijfer dat day-to-day ertoe doet: een plafond zonder verbruiksgegevens vertelt u niet of u op 10% of 95% van uw budget zit.
Limieten instellen
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
}'
Gedrag bij overschrijding
Dit is het geruststellende deel, en het is belangrijk dit expliciet te stellen: het bereiken van de limiet leidt nooit tot te hoge facturatie. Verzoeken worden geweigerd, niet gefactureerd boven het maximum. Het risico verschuift van financieel naar beschikbaarheid—precies wat u wilt, want een storing wordt binnen enkele minuten gediagnosticeerd en opgelost, terwijl een onverwachte factuur te laat wordt ontdekt.
Wanneer het verbruik de ingestelde limiet bereikt:
- API-verzoeken worden geweigerd met een specifieke foutcode
- API-sleutels blijven actief, maar inferentie-aanroepen mislukken
- De limiet wordt gereset aan het begin van de volgende factureringscyclus
Limietstrategie per omgeving
Voor een team met meerdere projecten moet de limiet het riskspecifieke profiel van elke omgeving weerspiegelen. In ontwikkeling ligt het typische gevaar in een per ongeluk ontstane verzoeklus—een testscript dat de hele nacht draait—en een lage limiet van $50 tot $100 maakt van die fout een incident van $10 in plaats van een verrassing van $1.000. Staging verwerkt load-tests, die legitiem meer verbruiken: een matige limiet van $200 tot $500 biedt ruimte voor testcampagnes terwijl een vangrail behouden blijft. Productie daarentegen mag nooit zodanig worden beperkt dat clientverzoeken worden geweigerd: een hogere limiet ($1.000 en meer, afhankelijk van uw verkeer) gaat gepaard met actieve monitoring—de waarschuwing beschermt u, terwijl de limiet slechts het veiligheidsnet van laatste redmiddel is.
Huidige kosten bekijken
Om te zien waar u staat in de huidige cyclus:
curl "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/postpaid/invoice/preview" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dit endpoint retourneert de kosten die zijn opgebouwd sinds het begin van de cyclus. In verhouding tot het aantal verstreken dagen geeft dit meer dan een momentopname: het is een projectie. Het verbruiken van 40% van het budget na één derde van de maand is gezond; hetzelfde percentage van 40% na één tiende van de maand signaleert een overschrijding, en u heeft nog zevenentwintig dagen om actie te ondernemen.
Kostenmonitoring automatiseren
Drempelwaarde-waarschuwingsscript
import requests
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
ALERT_THRESHOLD = 0.80 # Waarschuwing bij 80% van de limiet
# Haal de limiet op
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)
# Haal het huidige verbruik op
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)
# Controleer de drempelwaarde
if monthly_limit > 0:
ratio = current_spend / monthly_limit
if ratio >= ALERT_THRESHOLD:
print(f"ALERT: {ratio*100:.1f}% van de limiet bereikt")
print(f" Uitgaven: ${current_spend:.2f} / ${monthly_limit:.2f}")
# Verstuur melding
Integratie met monitoring
Combineer de kostenvoorvertoning met uw monitoringoplossing (Grafana, Datadog, enz.) om realtime kostendashboards te creëren:
# Haal het huidige bedrag op om naar uw metrieksysteem te sturen
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
Limieten dynamisch aanpassen
De limiet staat niet in steen gebeiteld voor de factureringscyclus—en dat is maar goed ook, want de levenscyclus van een product volgt niet de boekhoudkalender. Voor een verwachte piek in verkeer, een productlancering of een marketingcampagne verhoogt u de limiet tijdelijk: niets is erger dan een betaalde campagne die gebruikers naar een service stuurt waarvan de API verzoeken weigert vanwege een bereikt plafond. Omgekeerd, als het maandbudget sneller dan verwacht op is, verlaagt u de limiet voor de rest van de cyclus en verandert u afwijking in een gecontroleerde beperking. Het meest kritieke geval blijft een kostenincident—een lus in productie, gedetecteerd misbruik: het direct verlagen van de limiet is uw noodstopknop, degene die het bloeden stopt terwijl u de oorzaak zoekt.
# Tijdelijk verhogen voor een 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}'
# Normale limiet herstellen na de piek
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}'
Belangrijkste punten
- Gebruik
GETenPOSTop/v1/billing/teams/{teamId}/postpaid/spending-limitsom limieten te bekijken en in te stellen - Wanneer de limiet wordt overschreden, worden API-verzoeken geweigerd (geen te hoge facturatie)
- De kostenvoorvertoning (
invoice/preview) stelt u in staat het verbruik in realtime te volgen - Automatiseer drempelwaarde-waarschuwingen om overschrijdingen te anticiperen
- Pas limieten aan per omgeving (dev, staging, productie)