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

Dostupni modeli

Lekcija 12 od 14 Ažurirano 29. srpnja 2026. Programer
Na ovoj stranici
  1. Otkrij dostupne modele
  2. Popis modela
  3. Upotreba u upravljanju ključevima
  4. Popis krajnjih točaka za ACL
  5. Odaberi pravi model
  6. Skripta za usporedbu modela
  7. Prati nove modele
  8. Kombiniraj modele i analitiku
  9. Ključne točke

Otkrij dostupne modele

Ova krajnja točka odgovara na pitanje za koje bi mogao pogrešno pretpostaviti da ga pamtiš napamet: koje modele tvoj tim zapravo može pozivati i po kojoj cijeni danas. Javna dokumentacija opisuje opći katalog; API opisuje tvoj katalog, uključujući trenutne cijene.

Jaz između ta dva nije teoretske prirode. Razine se mijenjaju, cijene fluctuiraju, a ID kopiran iz blog objave stare šest mjeseci rezultirat će greškom pristupa koju je teško dijagnosticirati. Učini navikom da upitaš ovu krajnju točku umjesto da nagađaš – to je također ono što tvoje skripte za usporedbu troškova čini pouzdanima tijekom vremena. Ove informacije ključne su za odabir pravog modela za tvoj slučaj upotrebe i proračun.

Popis modela

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Odgovor za svaki model sadrži:

  • ID: točan naziv koji treba koristiti u API pozivima (npr. grok-4.20-0309-reasoning)
  • Cluster: skupina poslužitelja koja hosta model
  • Cijena: cijena po milijun tokena za ulaz i izlaz
  • Mogućnosti: veličina konteksta, multimodalna podrška itd.

Upotreba u upravljanju ključevima

Ovdje ova krajnja točka postaje nezamjenjiva, a ne samo praktična. ACL koji imenuje nepostojeći model – jer se format ID-a promijenio ili je model povučen – ne izaziva glasnu grešku: jednostavno ne autorizira ništa, pa na kraju tražiš grešku u svom kodu. Provjeri ID na izvoru prije nego ga zaključaš u ključ.

{
  "acls": [
    "api-key:model:grok-4.20-0309-reasoning",
    "api-key:model:grok-4.3"
  ]
}

Ako ograničavaš ključ na specifične modele, prvo provjeri jesu li dostupni tvom timu putem ove krajnje točke.

Popis krajnjih točaka za ACL

Ista logika vrijedi i za krajnje točke: donji popis je mjerodavan za sastavljanje tvojih ACL-ova. Također pruža koristan uvid u stvarni opseg ključa – ključ ograničen na chat ne može generirati ugradnje (embeddings) niti obrađivati slike, bez obzira na modele na koje se inače referira.

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Dostupne krajnje točke su:

  • chat: tekstualni razgovori (chat completions)
  • embed: generiranje ugradnji (embeddings)
  • image: generiranje i analiza slika
  • models: popis modela
  • sample: uzorkovanje (sampling)
  • tokenize: tokenizacija teksta
  • documents: obrada dokumenata

Odaberi pravi model

Prema slučaju upotrebe

Slučaj upotrebePreporučeni modelZašto
Složeno rezoniranjegrok-4.20-0309-reasoningNapredni lanac misli
Jednostavni zadaci, veliki obujamgrok-4.3Brz, ekonomičan
Analiza slikaMultimodalni modelPodrška za viziju
Ugradnje / RAGEmbed modelOptimiziran za pretraživanje

Prema proračunu

Usporedi stope vraćene od API-ja, a ne one koje imaš na umu. Logika arbitraže je uvijek ista: zadatak klasifikacije ili ekstrakcije nema koristi od modela za rezoniranje, ipak plaćaš njegovu cijenu pri svakom pozivu – a ovo je upravo vrsta zadatka koju pokrećeš tisućama puta. Model za rezoniranje nužan je za složene analize.

Skripta za usporedbu modela

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Dohvati modele
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

models = response.json().get("models", [])

print(f"{'Model':<35} {'Ulaz ($/M)':<15} {'Izlaz ($/M)':<15}")
print("-" * 65)

for model in models:
    name = model.get("id", "N/A")
    input_price = model.get("inputPrice", "N/A")
    output_price = model.get("outputPrice", "N/A")
    print(f"{name:<35} {input_price:<15} {output_price:<15}")

Prati nove modele

Katalog se mijenja nekoliko puta godišnje, a najzanimljivije promjene nisu novi modeli već pad cijena starima. Periodična provjera koja uspoređuje s prethodnim zapisom označava oboje, a košta nekoliko redaka u cronu.

import requests
import json
import os

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
CACHE_FILE = "/tmp/xai_models_cache.json"

# Dohvati trenutne modele
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)
current_models = {m["id"] for m in response.json().get("models", [])}

# Usporedi s cacheom
if os.path.exists(CACHE_FILE):
    with open(CACHE_FILE) as f:
        cached_models = set(json.load(f))

    new_models = current_models - cached_models
    removed_models = cached_models - current_models

    if new_models:
        print(f"Novi modeli: {', '.join(new_models)}")
    if removed_models:
        print(f"Povučeni modeli: {', '.join(removed_models)}")

# Ažuriraj cache
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Kombiniraj modele i analitiku

Konačna unakrsna referenca je ono što pokreće odluku: s jedne strane koliko svaki model košta, s druge strane koliko ga koristiš. Skup i marginalan model ne zaslužuje pažnju; skup model koji apsorbira većinu tvojih zahtjeva prvi je kandidat za promjenu, a ovo je upravo ono što ova skripta iznosi na vidjelo u jednom retku.

# 1. Popis dostupnih modela
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analiza korištenja po modelu
curl -s -X POST "https://management-api.x.ai/v1/billing/teams/$TEAM_ID/usage" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "analyticsRequest": {
      "timeRange": {
        "startTime": "2026-03-01 00:00:00",
        "endTime": "2026-04-01 00:00:00",
        "timezone": "UTC"
      },
      "timeUnit": "MONTH",
      "values": [{"name": "tokens", "aggregation": "SUM"}],
      "groupBy": ["model"]
    }
  }' > /tmp/usage.json

# 3. Usporedba
python3 -c "
import json
with open('/tmp/models.json') as f:
    available = {m['id'] for m in json.load(f).get('models', [])}
with open('/tmp/usage.json') as f:
    used = {p.get('model') for p in json.load(f).get('dataPoints', [])}
unused = available - used
if unused:
    print(f'Dostupni modeli koji se ne koriste: {unused}')
"

Cijene od 5. kolovoza 2026. — cijene se redovito mijenjaju: prije bilo kakvog izračuna proračuna, provjeri trenutnu tarifu na službenoj stranici xAI modela i cijena.

Ključne točke

  • GET /auth/teams/{teamId}/models izlistava modele s cijenama i mogućnostima
  • GET /auth/teams/{teamId}/endpoints izlistava krajnje točke za ACL-ove
  • Koristi ove informacije za stvaranje API ključeva s preciznim ACL-ovima
  • Usporedi stope kako bi odabrao najekonomičniji model prilagođen tvojoj upotrebi
  • Redovito prati nove dostupne modele