Osnovni URL in prva zahteva
Na tej strani
Upravniški API: ločena nadzorna ravnina
Upravniški API (Management API) podjetja xAI je ločen od sklepalnega API-ja (inference API), ki ga uporabljaš za pošiljanje pozivov modelu Grok. Omogoča ti upravljanje virov: ustvarjanje in upravljanje ključev API, konfiguracijo obračunavanja, spremljanje porabe ter nadzor dostopa tvoje ekipe. Vse to upravljanje poteka prek namenskega URL-ja.
Osnovni URL
Ta ločitev ni le podrobnost izvedbe; odraža temeljno razliko med obema API-jema. Eden porablja žetone in poganja modele, drugi pa upravlja, obračunava in dodeljuje dovoljenja. Ločitev na dve domeni in dva niza ključev zagotavlja, da ukraden ključ aplikacije nikoli ne more ustvariti drugih ključev ali brati tvojih podatkov o obračunavanju.
https://management-api.x.ai
Ne zamenjaj tega z https://api.x.ai, ki je URL za sklepalne klice (dopolnitve klepeta, vgradnje itd.). Vse zahteve za upravljanje – ključi, obračunavanje, analitika – potekajo prek management-api.x.ai.
Avtentikacija upravniškega API-ja
Mehanizem avtentikacije je enak – žeton Bearer v glavi Authorization –, vendar sam ključ ni isti. To je najpogostejša zmeda pri začetku, ki povzroči popolnoma nejasno napako 401: v sporočilu o napaki ni ničesar, kar bi kazalo, da si preprosto predložil pravi ključ napačnemu API-ju.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ta zahteva za preverjanje veljavnosti (GET /auth/management-keys/validation) ti omogoča, da preveriš, ali je tvoj upravniški ključ veljaven in aktiven. To je najpreprostejša vstopna točka za testiranje tvoje konfiguracije.
Upravniški ključ proti sklepalnemu ključu
- Upravniški ključ: omogoča dostop do končnih točk
management-api.x.ai(upravljanje, obračunavanje, analitika) - Sklepalni ključ: omogoča dostop do končnih točk
api.x.ai(klepet, vgradnje, slike)
Oba tipa ključev sta ustvarjena v konzoli xAI, vendar se njuna obsega razlikujeta. Sklepalni ključ ne more dostopati do upravljalnih končnih točk in obratno.
Struktura končnih točk
Končne točke upravniškega API-ja sledijo logični organizaciji:
/auth/teams/{teamId}/api-keys— upravljanje ključev API/auth/api-keys/{apiKeyId}— operacije na določenem ključu/auth/teams/{teamId}/models— dostopni modeli/auth/teams/{teamId}/endpoints— razpoložljive končne točke ACL/v1/billing/teams/{teamId}/— obračunavanje in analitika
Parameter teamId je identifikator tvoje ekipe v konzoli xAI in strukturira skoraj vse končne točke. Vsaka ekipa ima svoje ključe, kvote in nastavitve obračunavanja, kar jo dela za naravno enoto izolacije: ločitev dveh projektov v dve ekipi loči tudi njuna proračuna in dostope brez kakršne koli dodatne konfiguracije.
Tvoja prva upravniška zahteva
Tukaj je popoln primer za potrditev tvoje konfiguracije:
# Določi svoj upravniški ključ
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Preveri veljavnost ključa
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Če odgovor vsebuje informacije o tvoji ekipi in ključu, tvoja konfiguracija deluje. Če prejmeš napako 401, preveri, ali uporabljaš upravniški ključ (in ne sklepalnega ključa).
Ključne ugotovitve
- Upravniški API uporablja
https://management-api.x.ai, ki je ločen odhttps://api.x.ai - Avtentikacija uporablja žeton Bearer v glavi
Authorization - Upravniški ključi in sklepalni ključi imajo ločene obsege
- Končna točka
GET /auth/management-keys/validationomogoča testiranje tvoje konfiguracije - Vse upravniške končne točke so organizirane okoli parametra
teamId