Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Dostupné modely

Lekcia 12 z 14 Aktualizované 29. júla 2026 Vývojár
Na tejto strane
  1. Objav dostupné modely
  2. Zoznam modelov
  3. Využitie pri správe kľúčov
  4. Zoznam koncových bodov ACL
  5. Výber správneho modelu
  6. Skript na porovnanie modelov
  7. Monitorovanie nových modelov
  8. Kombinácia modelov a analytiky
  9. Kľúčové poznatky

Objav dostupné modely

Tento koncový bod odpovedá na otázku, ktorú by si mohol mylne považovať za samozrejmú: ktoré modely môže tvoj tím skutočne volať a za akú cenu práve teraz. Verejná dokumentácia opisuje všeobecný katalóg; API opisuje tvoj katalóg vrátane aktuálnych cien.

Rozdiel medzi týmito dvoma zdrojmi nie je teoretický. Úrovne sa vyvíjajú, ceny sa menia a ID skopírované zo šesťmesačného blogového príspevku vyprodukuje chybu prístupu, ktorú sa ťažko diagnostikuje. Zvykni si dopytovať tento koncový bod namiesto toho, aby si predpokladal – je to aj to, čo udržuje tvoje skripty na porovnávanie nákladov v čase spoľahlivé. Tieto informácie sú nevyhnutné pre výber správneho modelu pre tvoj prípad použitia a rozpočet.

Zoznam modelov

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

Odpoveď obsahuje pre každý model:

  • ID: presný názov, ktorý treba použiť v API volaniach (napr. grok-4.20-0309-reasoning)
  • Cluster: skupina serverov hostujúca model
  • Ceny: cena za milión tokenov pre vstup a výstup
  • Schopnosti: veľkosť kontextu, podpora multimédií atď.

Využitie pri správe kľúčov

Tu sa tento koncový bod stáva nielen praktickým, ale nevyhnutným. ACL, ktoré menuje neexistujúci model – pretože sa zmenil formát ID alebo bol model vyradený – nehlási hlasnú chybu: jednoducho nič neautorizuje a ty nakoniec hľadáš chybu vo svojom kóde. Over si ID priamo pri zdroji skôr, než ho uzamkneš do kľúča.

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

Ak obmedzuješ kľúč na konkrétne modely, najprv over, či sú pre tvoj tím dostupné prostredníctvom tohto koncového bodu.

Zoznam koncových bodov ACL

Rovnaká logika platí aj pre koncové body: nižšie uvedený zoznam je autoritatívny pre zostavovanie tvojich ACL. Poskytuje tiež užitočný pohľad na skutočný rozsah kľúča – kľúč obmedzený na chat nemôže generovať vektory (embeddings) ani spracovávať obrázky, bez ohľadu na modely, na ktoré inak odkazuje.

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

Dostupné koncové body sú:

  • chat: textové konverzácie (dopĺňanie chatu)
  • embed: generovanie vektorov (embeddings)
  • image: generovanie a analýza obrázkov
  • models: zoznam modelov
  • sample: vzorkovanie
  • tokenize: tokenizácia textu
  • documents: spracovanie dokumentov

Výber správneho modelu

Podľa prípadu použitia

Prípad použitiaOdporúčaný modelPrečo
Komplexné usudzovaniegrok-4.20-0309-reasoningPokročilý reťazec myšlienok
Jednoduché úlohy, vysoký objemgrok-4.3Rýchly, ekonomický
Analýza obrázkovMultimodálny modelPodpora videnia
Vektory / RAGEmbed modelOptimalizovaný pre vyhľadávanie

Podľa rozpočtu

Porovnávaj sadzby vrátené API namiesto tých, ktoré máš v hlave. Logika arbitráže je vždy rovnaká: úloha klasifikácie alebo extrakcie nezíska žiadnu výhodu z modelu na usudzovanie, no za každé volanie zaplatíš jeho cenu – a práve toto je typ úlohy, ktorú spúšťaš tisíckrát. Model na usudzovanie je nevyhnutný pre komplexné analýzy.

Skript na porovnanie modelov

import requests
import json

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

# Získanie modelov
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} {'Vstup ($/M)':<15} {'Výstup ($/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}")

Monitorovanie nových modelov

Katalóg sa mení niekoľkokrát do roka a najzaujímavejšie zmeny nie sú nové modely, ale poklesy cien tých starých. Pravidelná kontrola, ktorá porovnáva stav s predchádzajúcim záznamom, odhalí oboje a stojí len niekoľko riadkov v crone.

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"

# Získanie aktuálnych modelov
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", [])}

# Porovnanie s cache
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"Nové modely: {', '.join(new_models)}")
    if removed_models:
        print(f"Odstránené modely: {', '.join(removed_models)}")

# Aktualizácia cache
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Kombinácia modelov a analytiky

Konečné krížové porovnanie je to, čo riadi rozhodovanie: na jednej strane, koľko stojí každý model, na druhej strane, koľko ho používaš. Drahý a marginálny model si nezaslúži pozornosť; drahý model, ktorý absorbuje väčšinu tvojich požiadaviek, je prvým kandidátom na zmenu a presne toto tento skript odhalí jedným riadkom.

# 1. Zoznam dostupných modelov
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analýza využitia podľa 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. Porovnanie
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'Dostupné nepoužívané modely: {unused}')
"

Ceny platné k 5. augustu 2026 – ceny sa pravidelne vyvíjajú: pred akýmkoľvek výpočtom rozpočtu si over aktuálny cenník na oficiálnej stránke modelov a cien xAI.

Kľúčové poznatky

  • GET /auth/teams/{teamId}/models vypíše modely s cenami a schopnosťami
  • GET /auth/teams/{teamId}/endpoints vypíše koncové body pre ACL
  • Použi tieto informácie na vytvorenie API kľúčov s presnými ACL
  • Porovnávaj sadzby, aby si vybral najekonomickejší model vhodný pre tvoje využitie
  • Pravidelne monitoruj nové dostupné modely