Management API: Nøgle- og fakturastyring
På denne side
Administrer din konto uden konsollen
xAI Management API er et REST-grænseflade dedikeret til styring af din Enterprise-konto. Hvor Inference API’et (api.x.ai) kalder modeller, administrerer Management API’et (management-api.x.ai) dine ressourcer. Distinktionen kan virke ubetydelig. Det er den ikke. Alt, der ellers ville kræve, at nogen åbner webkonsollen og klikker, bliver automatiserbart her – sporbart, reproducerbart og integrerbart med de værktøjer, dine hold allerede bruger.
Opret og roter nøgler
Oprettelse af nøgler via API’et lader dig automatisere klargøring til en ny applikation eller et nyt miljø:
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"
}'
Parametrene i denne anmodning definerer fuldt ud nøglens omfang:
- name: Menneskelæselig identifikator for nøglen
- acls: Liste over tilladelser (autoriserede endpoints og modeller)
- qps/qpm/tpm: Hastighedsgrænser pr. sekund, pr. minut og tokens pr. minut
- expireTime: Automatisk udløbsdato
At sætte expireTime ved oprettelse er den vane, der sparer dig for mest bøvl på lang sigt: en nøgle udstedt til et tre måneders pilotprojekt udløber af sig selv i stedet for at overleve på ubestemt tid i en konfigurationsfil, som ingen læser længere.
Regelmæssig nøglerotation følger den samme sikkerhedshygiejne. Det dedikerede endpoint genererer en ny hemmelig nøgle og ugyldiggør den gamle:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Advarsel: Den gamle hemmelige nøgle ugyldiggøres øjeblikkeligt og permanent. Forbered dig på at udrulle den nye værdi i din hemmelighedsadministrator, før du kører kommandoen, aldrig bagefter. Tre skrivebeskyttede endpoints fuldender sættet: GET /auth/teams/{teamId}/api-keys lister alle nøgler for teamet, GET /auth/api-keys/{apiKeyId}/propagation verificerer, at nøglen er propageret på tværs af alle noder, og GET /auth/teams/{teamId}/models lister tilgængelige modeller med deres priser. Det andet er det, du konsulterer lige efter en rotation, når en applikation stadig returnerer autentificeringsfejl, og du er usikker på, om det er en applikationsfejl eller blot en propageringsforsinkelse.
Spor og kontrolér fakturering
Hentning af faktureringsoplysninger bruger et dedikeret endpoint:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Du henter fakturahistorik med periodefiltrering, her for marts 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Hver faktura har en status blandt PENDING, PAID, FAILED og WILL_NEVER_BE_CHARGED. At synliggøre en FAILED-status i din overvågning er langt bedre end at få kendskab til hændelsen via en serviceafbrydelse en mandag morgen.
For at forhindre budgetoverskridelser skal du konfigurere en månedlig grænse:
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}'
Hvis du opererer på prepaid-basis, skal du tjekke saldoen på samme måde:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Husk, at prepaid-kreditter er ikke-refunderbare, medmindre loven kræver det. Dimensionér dine køb baseret på forbrug observeret over flere uger, ikke på optimistiske vækstprognoser.
Overvåg dit forbrug med den rette granularitet
Analytics-endpointet lader dig spore brug med fin granularitet:
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"]
}
}'
Denne anmodning returnerer det daglige tokenforbrug opdelt efter model for marts. Ved at ændre timeUnit skifter du fra en månedlig visning til en visning pr. minut: mulige værdier er MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR og MINUTE. Aggregeringer går langt ud over simple totaler med SUM, AVG, MIN, MAX, P50, P90, P99 og COUNT. Percentiler karakteriserer belastningen effektivt, fordi gennemsnit udjævner netop de toppe, der bestemmer den kapacitet, du faktisk har brug for.
Management API’et indtager derefter sin plads i dit værktøjssæt. Du klargør nøgler fra Terraform eller Pulumi ligesom en database, din CI/CD-pipeline opretter ephemere nøgler til testmiljøer og sletter dem ved afslutningen af eksekveringen, overvågningsscripts advarer, før udgiftsloftet nås, og dine interne dashboards viser forbrug uden at et menneske skal eksportere en CSV hver mandag.
Vigtige pointer
- Management API’et på management-api.x.ai håndterer nøgler, fakturering og målinger
- Nøglerotation ugyldiggør permanent den gamle hemmelige nøgle
- Udgrænsninger for udgifter beskytter mod budgetoverskridelser
- Brugsanalyser tilbyder granularitet fra minut til måned
- Integrer Management API’et i dine infrastrukturværktøjer for at automatisere administration