Management API: Beheer van sleutels en facturatie
Op deze pagina
Beheer uw account zonder de console
De xAI Management API is een REST-interface die specifiek is ontworpen voor het beheren van uw Enterprise-account. Waar de Inference API (api.x.ai) modellen aanroept, beheert de Management API (management-api.x.ai) uw resources. Het onderscheid lijkt misschien klein. Dat is het niet. Alles wat anders zou vereisen dat iemand de webconsole opent en klikt, wordt hier automatiseerbaar—traceerbaar, reproduceerbaar en integreerbaar met de tools die uw teams al gebruiken.
Sleutels aanmaken en roteren
Het aanmaken van sleutels via de API stelt u in staat om de voorziening voor een nieuwe applicatie of omgeving te automatiseren:
curl -X POST "https://management-api.x.ai/auth/teams/{teamId}/api-keys" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"name": "cle-production-chatbot",
"acls": ["api-key:endpoint:chat", "api-key:model:grok-4.3"],
"qps": 10,
"qpm": 100,
"tpm": 1000000,
"expireTime": "2026-12-31T23:59:59Z"
}'
De parameters in dit verzoek definiëren volledig de reikwijdte van de sleutel:
- name: Een voor mensen leesbare identificatie voor de sleutel
- acls: Lijst met machtigingen (geautoriseerde eindpunten en modellen)
- qps/qpm/tpm: Snelheidslimieten per seconde, per minuut en tokens per minuut
- expireTime: Automatische vervaldatum
Het instellen van expireTime bij het aanmaken is de gewoonte die u op de lange termijn de meeste problemen bespaart: een sleutel die is uitgegeven voor een proefperiode van drie maanden verloopt vanzelf, in plaats van voor onbepaalde tijd te blijven bestaan in een configuratiebestand dat niemand meer leest.
Regelmatige sleutelrotatie volgt dezelfde beveiligingshygiëne. Het specifieke eindpunt genereert een nieuwe geheime sleutel en maakt de oude ongeldig:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Waarschuwing: de oude geheime sleutel wordt onmiddellijk en permanent ongeldig gemaakt. Bereid u voor om de nieuwe waarde in uw secret manager te implementeren voordat u het commando uitvoert, nooit daarna. Drie read-only eindpunten maken de set compleet: GET /auth/teams/{teamId}/api-keys somt alle sleutels voor het team op, GET /auth/api-keys/{apiKeyId}/propagation verifieert dat de sleutel op alle knooppunten is gepropageerd, en GET /auth/teams/{teamId}/models somt de toegankelijke modellen op met hun prijzen. Het tweede eindpunt raadpleegt u direct na een rotatie, wanneer een applicatie nog steeds authenticatiefouten retourneert en u niet zeker weet of het een applicatiefout is of simpelweg een propagatievertraging.
Facturatie volgen en beheersen
Het ophalen van facturatiegegevens gebeurt via een specifiek eindpunt:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
U haalt de factuurgeschiedenis op met filtering op periode, hier voor maart 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Elke factuur heeft een status uit PENDING, PAID, FAILED en WILL_NEVER_BE_CHARGED. Het signaleren van een FAILED-status in uw monitoring is veel beter dan via een serviceonderbreking op een maandagochtend over het incident te horen.
Om budgetoverschrijdingen te voorkomen, configureert u een maandelijkse limiet:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/postpaid/spending-limits" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{"monthlyLimit": 5000}'
Als u op prepaid-basis werkt, controleert u het saldo op dezelfde manier:
# Saldo controleren
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Onthoud dat prepaid-tegoed niet-restitueerbaar is, tenzij wettelijk verplicht. Bepaal de omvang van uw aankopen op basis van het verbruik dat over meerdere weken is waargenomen, niet op optimistische groeiprognoses.
Monitor uw verbruik op de juiste granulariteit
Het analytics-eindpunt stelt u in staat het gebruik met fijne granulariteit te volgen:
curl -X POST "https://management-api.x.ai/v1/billing/teams/{teamId}/usage" \
-H "Authorization: Bearer $MANAGEMENT_KEY" \
-H "Content-Type: application/json" \
-d '{
"analyticsRequest": {
"timeRange": {
"startTime": "2026-03-01 00:00:00",
"endTime": "2026-04-01 00:00:00",
"timezone": "UTC"
},
"timeUnit": "DAY",
"values": [{"name": "tokens", "aggregation": "SUM"}],
"groupBy": ["model"]
}
}'
Dit verzoek retourneert het dagelijkse tokenverbruik, uitgesplitst per model, voor maart. Door timeUnit te wijzigen, schakelt u van een maandoverzicht naar een overzicht per minuut: mogelijke waarden zijn MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR en MINUTE. Aggregaties gaan veel verder dan simpele totalen, met SUM, AVG, MIN, MAX, P50, P90, P99 en COUNT. Percentielen karakteriseren de belasting effectief omdat gemiddelden juist die pieken wegvlakken die bepalen welke capaciteit u daadwerkelijk nodig heeft.
De Management API neemt vervolgens zijn plaats in uw toolchain in. U voorziet sleutels vanuit Terraform of Pulumi net als een database, uw CI/CD-pipeline maakt tijdelijke sleutels aan voor testomgevingen en verwijdert deze aan het einde van de uitvoering, monitoring-scripts slaan alarm voordat de uitgavenlimiet wordt bereikt, en uw interne dashboards tonen het verbruik zonder dat een mens elke maandag een CSV exporteert.
Belangrijkste punten
- De Management API op management-api.x.ai beheert sleutels, facturatie en metrieken
- Sleutelrotatie maakt de oude geheime sleutel permanent ongeldig
- Uitgavenlimieten beschermen tegen budgetoverschrijdingen
- Gebruiksanalyses bieden granulariteit van minuut tot maand
- Integreer de Management API in uw infrastructuurtools om administratie te automatiseren