Hoppa till huvudinnehåll
Svenska— Välj ett språk
Meny

Base-URL och första förfrågan

Lektion 1 av 14 Uppdaterad 29 juli 2026 Utvecklare
På denna sida
  1. Management API: Ett separat kontrollplan
  2. Base-URL
  3. Autentisering för Management API
  4. Slutpunktsstruktur
  5. Din första hanteringsförfrågan
  6. Viktiga punkter

Management API: Ett separat kontrollplan

xAI:s Management API skiljer sig från det inferens-API du använder för att skicka prompts till Grok. Det låter dig administrera dina resurser: skapa och hantera API-nycklar, konfigurera fakturering, övervaka användning och kontrollera ditt teams åtkomst. All denna administration sker via en dedikerad URL.

Base-URL

Denna uppdelning är ingen implementeringsdetalj: den speglar en fundamental skillnad mellan de två API:erna. Det ena konsumerar tokens och kör modeller; det andra administrerar, fakturerar och beviljar behörigheter. Att hålla dem på två olika domäner och med två uppsättningar nycklar garanterar att en stulen applikationsnyckel aldrig kan skapa andra nycklar eller läsa din faktureringsinformation.

https://management-api.x.ai

Blanda inte ihop detta med https://api.x.ai, vilket är URL:en för inferensanrop (chatkompletteringar, inbäddningar, etc.). Alla hanteringsförfrågningar – nycklar, fakturering, analys – går genom management-api.x.ai.

2
Distinkta URL:er
REST
Standardarkitektur
JSON
Utbytesformat
Bearer
Autentisering

Autentisering för Management API

Autentiseringsmekanismen är identisk – en Bearer-token i Authorization-headern – men själva nyckeln är det inte. Detta är den vanligaste källan till förvirring när du börjar, och det resulterar i ett helt ogenomskinligt 401-fel: inget i felmeddelandet indikerar att du helt enkelt presenterade rätt nyckel för fel API.

curl https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Denna valideringsförfrågan (GET /auth/management-keys/validation) låter dig verifiera att din hanteringsnyckel är giltig och aktiv. Det är den enklaste ingångspunkten för att testa din konfiguration.

Hanteringsnyckel kontra inferensnyckel

  • Hanteringsnyckel: ger åtkomst till management-api.x.ai-slutpunkter (administration, fakturering, analys)
  • Inferensnyckel: ger åtkomst till api.x.ai-slutpunkter (chatt, inbäddningar, bilder)

Båda nyckeltyperna genereras från xAI-konsolen, men deras omfång skiljer sig åt. En inferensnyckel kan inte komma åt hanteringsslutpunkter, och vice versa.

Slutpunktsstruktur

Management API:s slutpunkter följer en logisk organisation:

  • /auth/teams/{teamId}/api-keys — Hantering av API-nycklar
  • /auth/api-keys/{apiKeyId} — Operationer på en specifik nyckel
  • /auth/teams/{teamId}/models — Tillgängliga modeller
  • /auth/teams/{teamId}/endpoints — Tillgängliga ACL-slutpunkter
  • /v1/billing/teams/{teamId}/ — Fakturering och analys

Parametern teamId är ditt teams identifierare i xAI-konsolen, och den strukturerar nästan alla slutpunkter. Varje team har sina egna nycklar, kvoter och faktureringsinställningar – vilket gör det till den naturliga isoleringsenheten: att separera två projekt i två team separerar också deras budgetar och åtkomst, utan någon ytterligare konfiguration.

Din första hanteringsförfrågan

Här är ett komplett exempel för att validera din konfiguration:

# Definiera din hanteringsnyckel
export MANAGEMENT_API_KEY="xai-mgmt-..."

# Validera nyckeln
curl -s https://management-api.x.ai/auth/management-keys/validation \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool

Om svaret innehåller information om ditt team och din nyckel fungerar din konfiguration. Om du får ett 401-fel, verifiera att du använder en hanteringsnyckel (inte en inferensnyckel).

Viktiga punkter

  • Management API använder https://management-api.x.ai, vilket skiljer sig från https://api.x.ai
  • Autentisering använder en Bearer-token i Authorization-headern
  • Hanteringsnycklar och inferensnycklar har separata omfång
  • Slutpunkten GET /auth/management-keys/validation låter dig testa din konfiguration
  • Alla hanteringsslutpunkter är organiserade kring teamId