Preskoči na glavni sadržaj
Hrvatski— Odaberite jezik
Izbornik

Osnovni URL i prvi zahtjev

Lekcija 1 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Upravljački API: zasebna upravljačka ravnina
  2. Osnovni URL
  3. Autentifikacija Upravljačkog API-ja
  4. Struktura krajnjih točaka
  5. Tvoj prvi zahtjev za upravljanje
  6. Ključne točke

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.

2
Različiti URL-ovi
REST
Standardna arhitektura
JSON
Format razmjene
Bearer
Autentifikacija

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 od https://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/validation omogućuje testiranje tvoje konfiguracije
  • Sve krajnje točke za upravljanje organizirane su oko teamId