Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Uitgavenlimieten

Les 7 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. Beheer uw API-kosten
  2. Huidige limieten bekijken
  3. Limieten instellen
  4. Huidige kosten bekijken
  5. Kostenmonitoring automatiseren
  6. Limieten dynamisch aanpassen
  7. Belangrijkste punten

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 GET en POST op /v1/billing/teams/{teamId}/postpaid/spending-limits om 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)