Osnovni URL i prvi zahtjev
Na ovoj stranici
Upravljački API: zasebna upravljačka ravnina
xAI-jev Upravljački API razlikuje se od API-ja za zaključivanje koji koristiš za slanje upita modelu Grok. On ti omogućuje administraciju resursa: stvaranje i upravljanje API ključevima, konfiguriranje naplate, praćenje korištenja te kontrolu pristupa tvog tima. Sva se ova administracija odvija putem namjenske URL adrese.
Osnovni URL
Ova odvojenost nije samo tehnički detalj implementacije: ona odražava temeljnu razliku između ta dva API-ja. Jedan troši tokene i pokreće modele; drugi administrira, naplaćuje i dodjeljuje dopuštenja. Njihovo držanje na dvjema različitim domenama i s dva skupa ključeva jamči da ukradeni ključ aplikacije nikada ne može stvoriti druge ključeve niti čitati tvoje podatke o naplati.
https://management-api.x.ai
Nemoj ovo zamijeniti s https://api.x.ai, što je URL za pozive zaključivanja (dovršavanja razgovora, ugradnje itd.). Svi zahtjevi za upravljanje – ključevi, naplata, analitika – idu kroz management-api.x.ai.
Autentifikacija Upravljačkog API-ja
Mehanizam autentifikacije identičan je – Bearer token u zaglavlju Authorization – ali sam ključ nije. Ovo je najčešća zabuna kod početnika i rezultira savršeno nejasnom pogreškom 401: ništa u poruci o pogrešci ne ukazuje na to da si jednostavno predočio ispravan ključ pogrešnom API-ju.
curl https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Ovaj zahtjev za validaciju (GET /auth/management-keys/validation) omogućuje ti provjeru je li tvoj ključ za upravljanje valjan i aktivan. To je najjednostavnija ulazna točka za testiranje tvoje konfiguracije.
Ključ za upravljanje naspram ključa za zaključivanje
- Ključ za upravljanje: dodjeljuje pristup krajnjim točkama
management-api.x.ai(administracija, naplata, analitika) - Ključ za zaključivanje: dodjeljuje pristup krajnjim točkama
api.x.ai(razgovor, ugradnje, slike)
Obje vrste ključeva generiraju se iz xAI konzole, ali se njihovi opsezi razlikuju. Ključ za zaključivanje ne može pristupiti krajnjim točkama za upravljanje i obrnuto.
Struktura krajnjih točaka
Krajnje točke Upravljačkog API-ja slijede logičnu organizaciju:
/auth/teams/{teamId}/api-keys— upravljanje API ključevima/auth/api-keys/{apiKeyId}— operacije na određenom ključu/auth/teams/{teamId}/models— dostupni modeli/auth/teams/{teamId}/endpoints— dostupne ACL krajnje točke/v1/billing/teams/{teamId}/— naplata i analitika
Parametar teamId je identifikator tvog tima u xAI konzoli i on strukturira gotovo sve krajnje točke. Svaki tim ima svoje ključeve, kvote i postavke naplate – što ga čini prirodnom jedinicom izolacije: razdvajanje dva projekta u dva tima također razdvaja njihove proračune i pristup, bez ikakve dodatne konfiguracije.
Tvoj prvi zahtjev za upravljanje
Evo potpunog primjera za validaciju tvoje konfiguracije:
# Definiraj svoj ključ za upravljanje
export MANAGEMENT_API_KEY="xai-mgmt-..."
# Validiraj ključ
curl -s https://management-api.x.ai/auth/management-keys/validation \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" | python3 -m json.tool
Ako odgovor sadrži informacije o tvom timu i ključu, tvoja konfiguracija radi. Ako dobiješ pogrešku 401, provjeri koristiš li ključ za upravljanje (a ne ključ za zaključivanje).
Ključne točke
- Upravljački API koristi
https://management-api.x.ai, što je različito odhttps://api.x.ai - Autentifikacija koristi Bearer token u zaglavlju
Authorization - Ključevi za upravljanje i ključevi za zaključivanje imaju odvojene opsege
- Krajnja točka
GET /auth/management-keys/validationomogućuje testiranje tvoje konfiguracije - Sve krajnje točke za upravljanje organizirane su oko
teamId