Management API: Hantering av nycklar och fakturering
På denna sida
Hantera ditt konto utan konsolen
xAI Management API är ett REST-gränssnitt dedikerat till hantering av ditt företagskonto. Där Inference API (api.x.ai) anropar modeller, administrerar Management API (management-api.x.ai) dina resurser. Skillnaden kan verka liten. Det är den inte. Allt som annars skulle kräva att någon öppnar webbkonsolen och klickar blir här automatiserbart – spårbart, reproducerbart och integrerbart med de verktyg dina team redan använder.
Provisionera och rotera nycklar
Att skapa nycklar via API:t låter dig automatisera provisionering för en ny applikation eller 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"
}'
Parametrarna i denna begäran definierar helt nyckelns omfattning:
- name: Människoläsbar identifierare för nyckeln
- acls: Lista över behörigheter (auktoriserade slutpunkter och modeller)
- qps/qpm/tpm: Hastighetsbegränsningar per sekund, per minut och tokens per minut
- expireTime: Automatiskt utgångsdatum
Att ange expireTime vid skapandet är den vana som sparar dig mest besvär i längden: en nyckel utfärdad för en tre månader lång pilotperiod löper ut av sig själv istället för att leva vidare på obestämd tid i en konfigurationsfil som ingen längre läser.
Regelbunden nyckelrotation följer samma säkerhetshygien. Den dedikerade slutpunkten genererar en ny hemlig nyckel och ogiltigförklarar den gamla:
curl -X POST "https://management-api.x.ai/auth/api-keys/{apiKeyId}/rotate" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Varning: den gamla hemliga nyckeln ogiltigförklaras omedelbart och permanent. Förbered dig på att distribuera det nya värdet i din hemlighetshanterare innan du kör kommandot, aldrig efteråt. Tre skrivskyddade slutpunkter kompletterar uppsättningen: GET /auth/teams/{teamId}/api-keys listar alla nycklar för teamet, GET /auth/api-keys/{apiKeyId}/propagation verifierar att nyckeln har propagerats till alla noder, och GET /auth/teams/{teamId}/models listar tillgängliga modeller med deras prissättning. Den andra är den du konsulterar direkt efter en rotation, när en applikation fortfarande returnerar autentiseringsfel och du är osäker på om det är ett applikationsfel eller helt enkelt en propageringsfördröjning.
Spåra och kontrollera fakturering
Hämtning av faktureringsinformation använder en dedikerad slutpunkt:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/billing-info" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Du hämtar fakturahistorik med periodfiltrering, här för mars 2026:
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/invoices?billingCycle.year=2026&billingCycle.month=3" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Varje faktura har en status bland PENDING, PAID, FAILED och WILL_NEVER_BE_CHARGED. Att synliggöra en FAILED-status i din övervakning är långt bättre än att få reda på incidenten via ett serviceavbrott på en måndag morgon.
För att förhindra budgetöverskridanden konfigurerar du en månatlig takgräns:
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}'
Om du arbetar med förbetalning kontrollerar du saldot på samma sätt:
# Check balance
curl "https://management-api.x.ai/v1/billing/teams/{teamId}/prepaid/balance" \
-H "Authorization: Bearer $MANAGEMENT_KEY"
Kom ihåg att förbetalda krediter är icke-återbetalningsbara, om inte lagen kräver annat. Dimensionera dina inköp baserat på konsumtion observerad över flera veckor, inte på optimistiska tillväxtprognoser.
Övervaka din konsumtion på rätt detaljnivå
Analys-slutpunkten låter dig spåra användning 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"]
}
}'
Denna begäran returnerar daglig tokenkonsumtion, uppdelad efter modell, för mars. Genom att ändra timeUnit växlar du från en månadsvy till en vy per minut: möjliga värden är MONTH, CALENDAR_WEEK, DAY, HOUR, QUARTER_HOUR och MINUTE. Aggregeringar går långt bortom enkla summor, med SUM, AVG, MIN, MAX, P50, P90, P99 och COUNT. Percentiler karakteriserar belastningen effektivt eftersom medelvärden utjämnar just de toppar som avgör den kapacitet du faktiskt behöver.
Management API intar sedan sin plats i din verktygskedja. Du provisionerar nycklar från Terraform eller Pulumi precis som en databas, din CI/CD-pipeline skapar efemära nycklar för testmiljöer och tar sedan bort dem vid körningens slut, övervakningsskript varnar innan utgiftstaket nås, och dina interna dashboards visar konsumtion utan att en människa behöver exportera en CSV varje måndag.
Viktiga punkter
- Management API på management-api.x.ai hanterar nycklar, fakturering och metrik
- Nyckelrotation ogiltigförklarar den gamla hemliga nyckeln permanent
- Utgiftsgränser skyddar mot budgetöverskridanden
- Användningsanalys erbjuder granularitet från minut till månad
- Integrera Management API i dina infrastrukturverktyg för att automatisera administration