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

Razpoložljivi modeli

Lekcija 12 od 14 Posodobljeno 29. julij 2026 Razvijalec
Na tej strani
  1. Odkrij razpoložljive modele
  2. Seznam modelov
  3. Uporaba pri upravljanju ključev
  4. Seznam končnih točk ACL
  5. Izberi pravi model
  6. Skripta za primerjavo modelov
  7. Spremljaj nove modele
  8. Združi modele in analitiko
  9. Ključne ugotovitve

Odkrij razpoložljive modele

Ta končna točka odgovarja na vprašanje, za katerega bi lahko pomotoma mislil, da ga znaš rešiti iz spomina: katere modele lahko tvoja ekipa dejansko kliče in po kakšni ceni danes. Javna dokumentacija opisuje splošni katalog; API pa opisuje tvoj katalog, vključno s trenutnimi cenami.

Razlika med obema ni teoretična. Stopnje se spreminjajo, cene nihajo in ID, kopiran iz šest mesecev starega bloga, povzroči napako pri dostopu, ki jo je težko diagnosticirati. Naj bo tvoja navada poizvedovati po tej končni točki, namesto da predpostavljaš – prav to ohranja tvoje skripte za primerjavo stroškov zanesljive skozi čas. Te informacije so ključne za izbiro pravega modela za tvojo uporabo in proračun.

Seznam modelov

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

Odgovor za vsak model vsebuje:

  • ID: točno ime za uporabo v klicih API (npr. grok-4.20-0309-reasoning)
  • Sklop strežnikov (Cluster): skupina strežnikov, ki gosti model
  • Cenik: cena na milijon žetonov za vhod in izhod
  • Zmožnosti: velikost konteksta, podpora za večpredstavnost itd.

Uporaba pri upravljanju ključev

Tu končna točka postane nepogrešljiva, ne le praktična. ACL, ki imenuje neobstoječ model – ker se je format ID spremenil ali je bil model umaknjen – ne sproži glasne napake: preprosto ne avtorizira ničesar in končaš z iskanjem napake v svoji kodi. Preveri ID pri viru, preden ga zakleneš v ključ.

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

Če ključ omejiš na določene modele, najprej preveri, ali so na voljo tvoji ekipi prek te končne točke.

Seznam končnih točk ACL

Enaka logika velja za končne točke: spodnji seznam je avtoritativen za sestavljanje tvojih ACL-jev. Zagotavlja tudi uporaben vpogled v dejanski obseg ključa – ključ, omejen na chat, ne more generirati vgradenj niti obdelovati slik, ne glede na modele, na katere se sicer sklicuje.

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

Razpoložljive končne točke so:

  • chat: besedilni pogovori (dopolnitve klepeta)
  • embed: generiranje vgradenj
  • image: generiranje in analiza slik
  • models: seznam modelov
  • sample: vzorčenje
  • tokenize: tokenizacija besedila
  • documents: obdelava dokumentov

Izberi pravi model

Glede na primer uporabe

Primer uporabePriporočeni modelZakaj
Kompleksno sklepanjegrok-4.20-0309-reasoningNapredno verigo razmišljanja
Preproste naloge, velika količinagrok-4.3Hitro, ekonomično
Analiza slikVečpredstavnostni modelPodpora za vid
Vgradnje / RAGModel za vgradnjeOptimizirano za iskanje

Glede na proračun

Primerjaj stopnje, ki jih vrne API, in ne tistih, ki jih imaš v mislih. Logika arbitraže je vedno enaka: naloga razvrščanja ali ekstrakcije nima koristi od modela za sklepanje, vendar plačaš njegovo ceno pri vsakem klicu – in to je ravno vrsta naloge, ki jo zaženeš tisočkrat. Model za sklepanje je nujen za kompleksne analize.

Skripta za primerjavo modelov

import requests
import json

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

# Pridobi 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} {'Vhod ($/M)':<15} {'Izhod ($/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}")

Spremljaj nove modele

Katalog se spremeni večkrat na leto, najbolj zanimive spremembe pa niso novi modeli, temveč padci cen starih. Periodični pregled, ki primerja s prejšnjim zapisom, zazna oboje in stane le nekaj vrstic v 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"

# Pridobi 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", [])}

# Primerjaj s predpomnilnikom
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"Odstranjeni modeli: {', '.join(removed_models)}")

# Posodobi predpomnilnik
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Združi modele in analitiko

Končno navzkrižno sklicevanje je tisto, ki poganja odločitev: na eni strani, koliko stane vsak model, na drugi strani, koliko ga uporabljaš. Drag in robni model ne zasluži pozornosti; drag model, ki požre večino tvojih zahtevkov, je prvi kandidat za spremembo, in prav to ta skripta razkrije v eni vrstici.

# 1. Izpiši razpoložljive modele
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analiziraj uporabo po modelih
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. Primerjaj
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'Razpoložljivi modeli, ki se ne uporabljajo: {unused}')
"

Cene z dne 5. avgusta 2026 – cene se redno spreminjajo: pred vsakim izračunom proračuna preveri trenutni cenik na uradni strani modelov in cen xAI.

Ključne ugotovitve

  • GET /auth/teams/{teamId}/models izpiše modele s cenami in zmožnostmi
  • GET /auth/teams/{teamId}/endpoints izpiše končne točke za ACL-je
  • Uporabi te informacije za ustvarjanje API ključev s natančnimi ACL-ji
  • Primerjaj stopnje za izbiro najbolj ekonomičnega modela, prilagojenega tvoji uporabi
  • Redno spremljaj nove razpoložljive modele