Base-URL en eerste verzoek
Op deze pagina
De Management API: een apart besturingsvlak
De Management API van xAI verschilt van de inferentie-API die u gebruikt om prompts naar Grok te sturen. Met deze API beheert u uw resources: u maakt en beheert API-sleutels, configureert facturatie, monitort het gebruik en regelt de toegang voor uw team. Dit volledige beheer verloopt via een specifieke URL.
Base-URL
Deze scheiding is geen implementatiedetail; ze weerspiegelt een fundamenteel verschil tussen de twee API’s. De ene API verbruikt tokens en draait modellen; de andere beheert, factureert en verleent rechten. Door ze op twee verschillende domeinen en met twee sets sleutels te laten werken, garandeert u dat een gestolen applicatiesleutel nooit andere sleutels kan aanmaken of uw factuurgegevens kan inzien.
https://management-api.x.ai
Verwar dit niet met https://api.x.ai, de URL voor inferentie-aanroepen (chat-completions, embeddings, enz.). Alle beheeraanvragen—voor sleutels, facturatie en analytics—lopen via management-api.x.ai.
Authenticatie voor de Management API
Het authenticatiemechanisme is identiek: een Bearer-token in de Authorization-header. De sleutel zelf is echter anders. Dit is de meest voorkomende verwarring bij het beginnen, en het resulteert in een volkomen onduidelijke 401-fout: niets in het foutbericht geeft aan dat u simpelweg de juiste sleutel bij de verkeerde API hebt aangeboden.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Met deze validatieaanvraag (GET /auth/management-keys/validation) verifieert u of uw beheersleutel geldig en actief is. Het is het eenvoudigste startpunt om uw configuratie te testen.
Beheersleutel versus inferentiesleutel
- Beheersleutel: verleent toegang tot eindpunten van
management-api.x.ai(beheer, facturatie, analytics) - Inferentiesleutel: verleent toegang tot eindpunten van
api.x.ai(chat, embeddings, afbeeldingen)
Beide sleuteltypen worden gegenereerd in de xAI-console, maar hun reikwijdte verschilt. Een inferentiesleutel heeft geen toegang tot beheereindpunten, en andersom ook niet.
Structuur van de eindpunten
De eindpunten van de Management API volgen een logische indeling:
/auth/teams/{teamId}/api-keys— beheer van API-sleutels/auth/api-keys/{apiKeyId}— bewerkingen op een specifieke sleutel/auth/teams/{teamId}/models— beschikbare modellen/auth/teams/{teamId}/endpoints— beschikbare ACL-eindpunten/v1/billing/teams/{teamId}/— facturatie en analytics
De parameter teamId is de identificatie van uw team in de xAI-console en vormt de basis voor bijna alle eindpunten. Elk team heeft zijn eigen sleutels, quota’s en facturatie-instellingen. Dit maakt het team de natuurlijke isolatie-eenheid: door twee projecten in twee aparte teams onder te brengen, scheidt u ook hun budgetten en toegang, zonder extra configuratie.
Uw eerste beheeraanvraag
Hier volgt een compleet voorbeeld om uw configuratie te valideren:
# Definieer uw beheersleutel
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Valideer de sleutel
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Als het antwoord informatie over uw team en sleutel bevat, werkt uw configuratie correct. Krijgt u een 401-fout? Controleer dan of u een beheersleutel gebruikt en geen inferentiesleutel.
Belangrijkste punten
- De Management API gebruikt
https://management-api.x.ai, wat verschilt vanhttps://api.x.ai - Authenticatie verloopt via een Bearer-token in de
Authorization-header - Beheersleutels en inferentiesleutels hebben gescheiden reikwijdtes
- Het eindpunt
GET /auth/management-keys/validationstelt u in staat uw configuratie te testen - Alle beheereindpunten zijn georganiseerd rondom de
teamId