Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Osnovni URL in prva zahteva

Lekcija 1 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Upravniški API: ločena nadzorna ravnina
  2. Osnovni URL
  3. Avtentikacija upravniškega API-ja
  4. Struktura končnih točk
  5. Tvoja prva upravniška zahteva
  6. Ključne ugotovitve

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.

2
Ločeni URL-ji
REST
Standardna arhitektura
JSON
Format izmenjave
Bearer
Avtentikacija

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 od https://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/validation omogoča testiranje tvoje konfiguracije
  • Vse upravniške končne točke so organizirane okoli parametra teamId