Razpoložljivi modeli
Na tej strani
Odkrij razpoložljive modele
Ta končna točka odgovarja na vprašanje, za katerega bi lahko pomotoma mislil, da ga znaš rešiti iz spomina: katere modele lahko tvoja ekipa dejansko kliče in po kakšni ceni danes. Javna dokumentacija opisuje splošni katalog; API pa opisuje tvoj katalog, vključno s trenutnimi cenami.
Razlika med obema ni teoretična. Stopnje se spreminjajo, cene nihajo in ID, kopiran iz šest mesecev starega bloga, povzroči napako pri dostopu, ki jo je težko diagnosticirati. Naj bo tvoja navada poizvedovati po tej končni točki, namesto da predpostavljaš – prav to ohranja tvoje skripte za primerjavo stroškov zanesljive skozi čas. Te informacije so ključne za izbiro pravega modela za tvojo uporabo in proračun.
Seznam modelov
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor za vsak model vsebuje:
- ID: točno ime za uporabo v klicih API (npr.
grok-4.20-0309-reasoning) - Sklop strežnikov (Cluster): skupina strežnikov, ki gosti model
- Cenik: cena na milijon žetonov za vhod in izhod
- Zmožnosti: velikost konteksta, podpora za večpredstavnost itd.
Uporaba pri upravljanju ključev
Tu končna točka postane nepogrešljiva, ne le praktična. ACL, ki imenuje neobstoječ model – ker se je format ID spremenil ali je bil model umaknjen – ne sproži glasne napake: preprosto ne avtorizira ničesar in končaš z iskanjem napake v svoji kodi. Preveri ID pri viru, preden ga zakleneš v ključ.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Če ključ omejiš na določene modele, najprej preveri, ali so na voljo tvoji ekipi prek te končne točke.
Seznam končnih točk ACL
Enaka logika velja za končne točke: spodnji seznam je avtoritativen za sestavljanje tvojih ACL-jev. Zagotavlja tudi uporaben vpogled v dejanski obseg ključa – ključ, omejen na chat, ne more generirati vgradenj niti obdelovati slik, ne glede na modele, na katere se sicer sklicuje.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Razpoložljive končne točke so:
- chat: besedilni pogovori (dopolnitve klepeta)
- embed: generiranje vgradenj
- image: generiranje in analiza slik
- models: seznam modelov
- sample: vzorčenje
- tokenize: tokenizacija besedila
- documents: obdelava dokumentov
Izberi pravi model
Glede na primer uporabe
| Primer uporabe | Priporočeni model | Zakaj |
|---|---|---|
| Kompleksno sklepanje | grok-4.20-0309-reasoning | Napredno verigo razmišljanja |
| Preproste naloge, velika količina | grok-4.3 | Hitro, ekonomično |
| Analiza slik | Večpredstavnostni model | Podpora za vid |
| Vgradnje / RAG | Model za vgradnje | Optimizirano za iskanje |
Glede na proračun
Primerjaj stopnje, ki jih vrne API, in ne tistih, ki jih imaš v mislih. Logika arbitraže je vedno enaka: naloga razvrščanja ali ekstrakcije nima koristi od modela za sklepanje, vendar plačaš njegovo ceno pri vsakem klicu – in to je ravno vrsta naloge, ki jo zaženeš tisočkrat. Model za sklepanje je nujen za kompleksne analize.
Skripta za primerjavo modelov
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Pridobi modele
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} {'Vhod ($/M)':<15} {'Izhod ($/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}")
Spremljaj nove modele
Katalog se spremeni večkrat na leto, najbolj zanimive spremembe pa niso novi modeli, temveč padci cen starih. Periodični pregled, ki primerja s prejšnjim zapisom, zazna oboje in stane le nekaj vrstic 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"
# Pridobi trenutne modele
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", [])}
# Primerjaj s predpomnilnikom
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"Novi modeli: {', '.join(new_models)}")
if removed_models:
print(f"Odstranjeni modeli: {', '.join(removed_models)}")
# Posodobi predpomnilnik
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Združi modele in analitiko
Končno navzkrižno sklicevanje je tisto, ki poganja odločitev: na eni strani, koliko stane vsak model, na drugi strani, koliko ga uporabljaš. Drag in robni model ne zasluži pozornosti; drag model, ki požre večino tvojih zahtevkov, je prvi kandidat za spremembo, in prav to ta skripta razkrije v eni vrstici.
# 1. Izpiši razpoložljive modele
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Analiziraj uporabo po modelih
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. Primerjaj
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'Razpoložljivi modeli, ki se ne uporabljajo: {unused}')
"
Cene z dne 5. avgusta 2026 – cene se redno spreminjajo: pred vsakim izračunom proračuna preveri trenutni cenik na uradni strani modelov in cen xAI.
Ključne ugotovitve
GET /auth/teams/{teamId}/modelsizpiše modele s cenami in zmožnostmiGET /auth/teams/{teamId}/endpointsizpiše končne točke za ACL-je- Uporabi te informacije za ustvarjanje API ključev s natančnimi ACL-ji
- Primerjaj stopnje za izbiro najbolj ekonomičnega modela, prilagojenega tvoji uporabi
- Redno spremljaj nove razpoložljive modele