Elérhető modellek
Ezen az oldalon
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 eset | Ajánlott modell | Miért |
|---|---|---|
| Komplex következtetés | grok-4.20-0309-reasoning | Fejlett gondolatmenet-lánc |
| Egyszerű feladatok, nagy volumen | grok-4.3 | Gyors, gazdaságos |
| Képelemzés | Multimodális modell | Látási támogatás |
| Beágyazások / RAG | Beágyazó modell | Keresé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}/modelslistázza a modelleket árazással és képességekkel - A
GET /auth/teams/{teamId}/endpointslistá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