Přejít na hlavní obsah
Čeština— Vyberte jazyk
Menu

Dostupné modely

Lekce 12 z 14 Aktualizováno 29. července 2026 Vývojář
Na této stránce
  1. Objev dostupné modely
  2. Výpis modelů
  3. Využití při správě klíčů
  4. Výpis koncových bodů ACL
  5. Výběr správného modelu
  6. Skript pro porovnání modelů
  7. Sledování nových modelů
  8. Kombinace modelů a analytiky
  9. Klíčové poznatky

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ý modelProč
Složité usuzovánígrok-4.20-0309-reasoningPokročilý řetězec myšlenek
Jednoduché úkoly, vysoký objemgrok-4.3Rychlý, ekonomický
Analýza obrázkůMultimodální modelPodpora vidění
Embeddingy / RAGEmbed modelOptimalizová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}/models vypisuje modely s cenami a schopnostmi
  • GET /auth/teams/{teamId}/endpoints vypisuje 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