Dostupné modely
Na tejto strane
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žitia | Odporúčaný model | Prečo |
|---|---|---|
| Komplexné usudzovanie | grok-4.20-0309-reasoning | Pokročilý reťazec myšlienok |
| Jednoduché úlohy, vysoký objem | grok-4.3 | Rýchly, ekonomický |
| Analýza obrázkov | Multimodálny model | Podpora videnia |
| Vektory / RAG | Embed model | Optimalizovaný 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}/modelsvypíše modely s cenami a schopnosťamiGET /auth/teams/{teamId}/endpointsvypíš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