Base-URL og første anmodning
På denne side
Management API: Et separat kontrolplan
xAI’s Management API er adskilt fra den inferens-API, du bruger til at sende prompts til Grok. Den giver dig mulighed for at administrere dine ressourcer: oprette og håndtere API-nøgler, konfigurere fakturering, overvåge forbrug og styre dit teams adgang. Al denne administration foregår via en dedikeret URL.
Base-URL
Denne adskillelse er ikke blot en implementeringsdetalje; den afspejler en fundamental forskel mellem de to API’er. Den ene forbruger tokens og kører modeller; den anden administrerer, fakturerer og tildeler tilladelser. Ved at holde dem på to forskellige domæner og med to sæt nøgler sikrer vi, at en stjålen applikationsnøgle aldrig kan oprette andre nøgler eller læse dine faktureringsoplysninger.
https://management-api.x.ai
Forveksl ikke dette med https://api.x.ai, som er URL’en til inferenskald (chat-fuldførelser, embeddings osv.). Alle administrationsanmodninger – nøgler, fakturering, analyser – går gennem management-api.x.ai.
Godkendelse i Management API
Godkendelsesmekanismen er identisk – et Bearer-token i Authorization-headern – men selve nøglen er det ikke. Dette er den hyppigste fejl, når man starter, og den resulterer i en fuldstændig uigennemsigtig 401-fejl: Intet i fejlmeddelelsen indikerer, at du blot har præsenteret den rigtige nøgle for det forkerte API.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Denne valideringsanmodning (GET /auth/management-keys/validation) lader dig verificere, at din administrationsnøgle er gyldig og aktiv. Det er det enkleste startpunkt for at teste din konfiguration.
Administrationsnøgle vs. inferensnøgle
- Administrationsnøgle: Giver adgang til
management-api.x.ai-endepunkter (administration, fakturering, analyser) - Inferensnøgle: Giver adgang til
api.x.ai-endepunkter (chat, embeddings, billeder)
Begge nøgletyper genereres fra xAI-konsollen, men deres omfang (scopes) er forskellige. En inferensnøgle kan ikke tilgå administrationsendepunkter, og omvendt.
Endepunktsstruktur
Management API-endepunkter følger en logisk organisering:
/auth/teams/{teamId}/api-keys— Håndtering af API-nøgler/auth/api-keys/{apiKeyId}— Operationer på en specifik nøgle/auth/teams/{teamId}/models— Tilgængelige modeller/auth/teams/{teamId}/endpoints— Tilgængelige ACL-endepunkter/v1/billing/teams/{teamId}/— Fakturering og analyser
Parameteren teamId er dit teams identifikator i xAI-konsollen, og den strukturerer næsten alle endepunkter. Hvert team har sine egne nøgler, kvoter og faktureringsindstillinger – hvilket gør det til den naturlige isoleringsenhed: At opdele to projekter i to teams adskiller også deres budgetter og adgange uden yderligere konfiguration.
Din første administrationsanmodning
Her er et komplet eksempel til validering af din konfiguration:
# Definer din administrationsnøgle
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Valider nøglen
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Hvis svaret indeholder dine team- og nøgleoplysninger, fungerer din konfiguration. Hvis du får en 401-fejl, skal du verificere, at du bruger en administrationsnøgle (og ikke en inferensnøgle).
Vigtige pointer
- Management API bruger
https://management-api.x.ai, hvilket er adskilt frahttps://api.x.ai - Godkendelse bruger et Bearer-token i
Authorization-headern - Administrationsnøgler og inferensnøgler har separate omfang
- Endepunktet
GET /auth/management-keys/validationlader dig teste din konfiguration - Alle administrationsendepunkter er organiseret omkring
teamId