Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Base-URL en eerste verzoek

Les 1 van 14 Bijgewerkt op 29 juli 2026 Ontwikkelaar
Op deze pagina
  1. De Management API: een apart besturingsvlak
  2. Base-URL
  3. Authenticatie voor de Management API
  4. Structuur van de eindpunten
  5. Uw eerste beheeraanvraag
  6. Belangrijkste punten

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.

2
Distinct URLs
REST
Standard Architecture
JSON
Exchange Format
Bearer
Authentication

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 van https://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/validation stelt u in staat uw configuratie te testen
  • Alle beheereindpunten zijn georganiseerd rondom de teamId