Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Elérhető modellek

12. lecke 14 közül Frissítve 2026. július 29. Fejlesztő
Ezen az oldalon
  1. Fedezd fel az elérhető modelleket
  2. Modellek listázása
  3. Használat kulcskezelés során
  4. ACL végpontok listázása
  5. Válaszd ki a megfelelő modellt
  6. Modell-összehasonlító szkript
  7. Figyeld az új modelleket
  8. Modellek és analitika összekapcsolása
  9. Főbb megállapítások

Fedezd fel az elérhető modelleket

Ez a végpont arra a kérdésre ad választ, amelyet tévesen fejben is megválaszolhatónak hihetsz: mely modelleket hívhatja meg valójában a csapatod, és mennyibe kerülnek ma? A nyilvános dokumentáció az általános katalógust írja le; az API a te katalógusodat, beleértve az aktuális árakat is.

A kettő közötti különbség nem elméleti. A szintek fejlődnek, az árak változnak, és egy hat hónapos blogbejegyzésből másolt azonosító olyan hozzáférési hibát eredményez, amelyet nehéz diagnosztizálni. Szoktasd rá magad, hogy ezt a végpontot kérdezed le ahelyett, hogy feltételeznél bármit is – ez biztosítja azt is, hogy költség-összehasonlító szkriptjeid idővel is megbízhatóak maradjanak. Ez az információ elengedhetetlen ahhoz, hogy a használati esetedhez és költségkeretedhez illő modellt válaszd ki.

Modellek listázása

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

A válasz minden modellre vonatkozóan tartalmazza:

  • ID: a pontos név, amelyet az API-hívásokban használnod kell (pl.: grok-4.20-0309-reasoning)
  • Cluster: a modellt hostoló szervercsoport
  • Árazás: bemeneti és kimeneti tokenenkénti ár milliónként
  • Képességek: kontextusméret, multimodális támogatás stb.

Használat kulcskezelés során

Itt válik a végpont nélkülözhetetlenné, nem csupán gyakorlatiassá. Egy ACL, amely egy nem létező modellt nevesít – mert az azonosító formátuma megváltozott, vagy a modellt nyugdíjazták –, nem dob hangos hibát: egyszerűen semmit sem engedélyez, és te a kódban keresgéled majd a hiba okát. Ellenőrizd az azonosítót a forrásnál, mielőtt beleégetnéd egy kulcsba.

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

Ha egy kulcsot konkrét modellekre korlátozol, először ezen a végponton ellenőrizd, hogy azok elérhetők-e a csapatod számára.

ACL végpontok listázása

Ugyanez a logika vonatkozik a végpontokra is: az alábbi lista a mérvadó az ACL-ek összeállításához. Hasznos betekintést nyújt egy kulcs tényleges hatókörébe is – egy chat-re korlátozott kulcs sem beágyazásokat (embeddings) generálni, sem képeket feldolgozni nem tud, függetlenül attól, hogy egyébként mely modellekre hivatkozik.

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

Az elérhető végpontok:

  • chat: szöveges beszélgetések (chat kiegészítések)
  • embed: beágyazások generálása
  • image: képgenerálás és -elemzés
  • models: modelllista
  • sample: mintavételezés
  • tokenize: szöveg tokenizálása
  • documents: dokumentumfeldolgozás

Válaszd ki a megfelelő modellt

Használati eset szerint

Használati esetAjánlott modellMiért
Komplex következtetésgrok-4.20-0309-reasoningFejlett gondolatmenet-lánc
Egyszerű feladatok, nagy volumengrok-4.3Gyors, gazdaságos
KépelemzésMultimodális modellLátási támogatás
Beágyazások / RAGBeágyazó modellKeresésre optimalizálva

Költségkeret szerint

Hasonlítsd össze az API által visszaadott díjakat azokkal, amelyekre emlékszel. Az arbitrázs logikája mindig ugyanaz: egy osztályozási vagy kinyerési feladat nem nyer semmit egy következtető modelltől, mégis megfizeted az árát minden hívásnál – márpedig pontosan az ilyen típusú feladatokat futtatod ezerszámra. A következtető modell csak komplex elemzésekhez szükséges.

Modell-összehasonlító szkript

import requests
import json

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

# Modellek lekérése
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

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

print(f"{'Modell':<35} {'Bemenet ($/M)':<15} {'Kimenet ($/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}")

Figyeld az új modelleket

A katalógus évente többször is változik, és a legérdekesebb változások nem az új modellek, hanem a régiek árcsökkenései. Egy időszakos ellenőrzés, amely összehasonlít az előző rekorddal, mindkettőt jelzi, és mindössze néhány soros cron feladatot igényel.

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"

# Aktuális modellek lekérése
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", [])}

# Összehasonlítás a gyorsítótárral
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"Új modellek: {', '.join(new_models)}")
    if removed_models:
        print(f"Eltávolított modellek: {', '.join(removed_models)}")

# Gyorsítótár frissítése
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Modellek és analitika összekapcsolása

A döntést meghozó végső keresztreferencia ez: az egyik oldalon, hogy mennyibe kerül minden modell, a másikon, hogy mennyit használod őket. Egy drága és marginális modell nem érdemel figyelmet; egy drága modell, amely a kéréseid nagy részét elnyeli, az első jelölt a változtatásra, és ezt hozza felszínre ez a szkript egyetlen sorban.

# 1. Elérhető modellek listázása
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Használat elemzése modellenként
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. Összehasonlítás
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'Elérhető, de nem használt modellek: {unused}')
"

Árak 2026. augusztus 5-i állapot szerint – az árak rendszeresen változnak: bármilyen költségvetési számítás előtt ellenőrizd az aktuális díjszabást a hivatalos xAI modell- és árinformációs oldalon.

Főbb megállapítások

  • A GET /auth/teams/{teamId}/models listázza a modelleket árazással és képességekkel
  • A GET /auth/teams/{teamId}/endpoints listázza az ACL-ekhez szükséges végpontokat
  • Használd ezt az információt pontos ACL-ekkel rendelkező API-kulcsok létrehozásához
  • Hasonlítsd össze a díjakat, hogy a használatodhoz leginkább illő, leggazdaságosabb modellt válaszd
  • Rendszeresen figyeld az új elérhető modelleket