Dostupné modely
Na této stránce
Objev dostupné modely
Tento koncový bod odpovídá na otázku, u které bys mohl mylně předpokládat, že ji zvládneš zpaměti: které modely může tvůj tým skutečně volat a za jakou cenu dnes. Veřejná dokumentace popisuje obecný katalog; API popisuje tvůj katalog, včetně aktuálních cen.
Rozdíl mezi těmito dvěma zdroji není teoretický. Úrovně se vyvíjejí, ceny se mění a ID zkopírované ze šest měsíců starého blogového příspěvku vyprodukuje chybu přístupu, kterou je těžké diagnostikovat. Zvykni si dotazovat tento koncový bod místo toho, abys něco předpokládal – je to také to, co udržuje tvoje skripty pro porovnávání nákladů spolehlivé v čase. Tyto informace jsou zásadní pro výběr správného modelu pro tvůj případ použití a rozpočet.
Výpis modelů
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odpověď obsahuje pro každý model:
- ID: přesný název k použití v voláních API (např.
grok-4.20-0309-reasoning) - Cluster: skupina serverů hostující model
- Ceny: cena za milion tokenů pro vstup a výstup
- Schopnosti: velikost kontextu, podpora multimédií atd.
Využití při správě klíčů
Zde se tento koncový bod stává nezbytným, nejen praktickým. ACL, které pojmenuje neexistující model – protože se změnil formát ID nebo byl model vyřazen – nehlásí hlasitou chybu: jednoduše nic neautorizuje a ty nakonec hledáš chybu ve svém kódu. Ověř ID u zdroje dříve, než ho uzamkneš do klíče.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Pokud omezíš klíč na konkrétní modely, nejprve ověř, zda jsou pro tvůj tým dostupné prostřednictvím tohoto koncového bodu.
Výpis koncových bodů ACL
Stejná logika platí pro koncové body: níže uvedený seznam je autoritativní pro sestavování tvých ACL. Poskytuje také užitečný pohled na skutečný rozsah klíče – klíč omezený na chat nemůže generovat embeddingy ani zpracovávat obrázky, bez ohledu na modely, na které jinak odkazuje.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dostupné koncové body jsou:
- chat: textové konverzace (doplňování chatu)
- embed: generování embeddingů
- image: generování a analýza obrázků
- models: seznam modelů
- sample: vzorkování
- tokenize: tokenizace textu
- documents: zpracování dokumentů
Výběr správného modelu
Podle případu použití
| Případ použití | Doporučený model | Proč |
|---|---|---|
| Složité usuzování | grok-4.20-0309-reasoning | Pokročilý řetězec myšlenek |
| Jednoduché úkoly, vysoký objem | grok-4.3 | Rychlý, ekonomický |
| Analýza obrázků | Multimodální model | Podpora vidění |
| Embeddingy / RAG | Embed model | Optimalizováno pro vyhledávání |
Podle rozpočtu
Porovnej sazby vrácené API místo těch, které máš v hlavě. Logika arbitráže je vždy stejná: úloha klasifikace nebo extrakce nezíská žádnou výhodu z usuzovacího modelu, přesto zaplatíš jeho cenu za každé volání – a toto je přesně typ úlohy, kterou spouštíš tisíckrát. Usuzovací model je nezbytný pro složité analýzy.
Skript pro porovnání modelů
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Získání modelů
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}")
Sledování nových modelů
Katalog se mění několikrát do roka a ty nejzajímavější změny nejsou nové modely, ale poklesy cen u těch starých. Pravidelná kontrola, která porovnává s předchozím záznamem, odhalí obojí a stojí jen několik řádků 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"
# Získání aktuálních modelů
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", [])}
# Porovnání s mezipamětí
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"Odstraněné modely: {', '.join(removed_models)}")
# Aktualizace mezipaměti
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Kombinace modelů a analytiky
Konečné křížové ověření je to, co řídí rozhodování: na jedné straně, kolik každý model stojí, na druhé straně, jak moc ho používáš. Drahý a okrajový model si nezaslouží pozornost; drahý model, který pohlcuje většinu tvých požadavků, je prvním kandidátem na změnu, a toto je přesně to, co tento skript odhalí jedním řádkem.
# 1. Výpis dostupných modelů
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žití podle 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. Porovnání
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žité modely: {unused}')
"
Ceny platné k 5. srpnu 2026 – ceny se pravidelně vyvíjejí: před jakýmkoli výpočtem rozpočtu ověř aktuální ceník na oficiální stránce modelů a cen xAI.
Klíčové poznatky
GET /auth/teams/{teamId}/modelsvypisuje modely s cenami a schopnostmiGET /auth/teams/{teamId}/endpointsvypisuje koncové body pro ACL- Použij tyto informace k vytvoření API klíčů s přesnými ACL
- Porovnej sazby a vyber nejekonomičtější model vhodný pro tvé využití
- Pravidelně sleduj nové dostupné modely