Dostupni modeli
Na ovoj stranici
Otkrij dostupne modele
Ova krajnja točka odgovara na pitanje za koje bi mogao pogrešno pretpostaviti da ga pamtiš napamet: koje modele tvoj tim zapravo može pozivati i po kojoj cijeni danas. Javna dokumentacija opisuje opći katalog; API opisuje tvoj katalog, uključujući trenutne cijene.
Jaz između ta dva nije teoretske prirode. Razine se mijenjaju, cijene fluctuiraju, a ID kopiran iz blog objave stare šest mjeseci rezultirat će greškom pristupa koju je teško dijagnosticirati. Učini navikom da upitaš ovu krajnju točku umjesto da nagađaš – to je također ono što tvoje skripte za usporedbu troškova čini pouzdanima tijekom vremena. Ove informacije ključne su za odabir pravog modela za tvoj slučaj upotrebe i proračun.
Popis modela
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Odgovor za svaki model sadrži:
- ID: točan naziv koji treba koristiti u API pozivima (npr.
grok-4.20-0309-reasoning) - Cluster: skupina poslužitelja koja hosta model
- Cijena: cijena po milijun tokena za ulaz i izlaz
- Mogućnosti: veličina konteksta, multimodalna podrška itd.
Upotreba u upravljanju ključevima
Ovdje ova krajnja točka postaje nezamjenjiva, a ne samo praktična. ACL koji imenuje nepostojeći model – jer se format ID-a promijenio ili je model povučen – ne izaziva glasnu grešku: jednostavno ne autorizira ništa, pa na kraju tražiš grešku u svom kodu. Provjeri ID na izvoru prije nego ga zaključaš u ključ.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Ako ograničavaš ključ na specifične modele, prvo provjeri jesu li dostupni tvom timu putem ove krajnje točke.
Popis krajnjih točaka za ACL
Ista logika vrijedi i za krajnje točke: donji popis je mjerodavan za sastavljanje tvojih ACL-ova. Također pruža koristan uvid u stvarni opseg ključa – ključ ograničen na chat ne može generirati ugradnje (embeddings) niti obrađivati slike, bez obzira na modele na koje se inače referira.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Dostupne krajnje točke su:
- chat: tekstualni razgovori (chat completions)
- embed: generiranje ugradnji (embeddings)
- image: generiranje i analiza slika
- models: popis modela
- sample: uzorkovanje (sampling)
- tokenize: tokenizacija teksta
- documents: obrada dokumenata
Odaberi pravi model
Prema slučaju upotrebe
| Slučaj upotrebe | Preporučeni model | Zašto |
|---|---|---|
| Složeno rezoniranje | grok-4.20-0309-reasoning | Napredni lanac misli |
| Jednostavni zadaci, veliki obujam | grok-4.3 | Brz, ekonomičan |
| Analiza slika | Multimodalni model | Podrška za viziju |
| Ugradnje / RAG | Embed model | Optimiziran za pretraživanje |
Prema proračunu
Usporedi stope vraćene od API-ja, a ne one koje imaš na umu. Logika arbitraže je uvijek ista: zadatak klasifikacije ili ekstrakcije nema koristi od modela za rezoniranje, ipak plaćaš njegovu cijenu pri svakom pozivu – a ovo je upravo vrsta zadatka koju pokrećeš tisućama puta. Model za rezoniranje nužan je za složene analize.
Skripta za usporedbu modela
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Dohvati 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} {'Ulaz ($/M)':<15} {'Izlaz ($/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}")
Prati nove modele
Katalog se mijenja nekoliko puta godišnje, a najzanimljivije promjene nisu novi modeli već pad cijena starima. Periodična provjera koja uspoređuje s prethodnim zapisom označava oboje, a košta nekoliko redaka u 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"
# Dohvati 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", [])}
# Usporedi s cacheom
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"Povučeni modeli: {', '.join(removed_models)}")
# Ažuriraj cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Kombiniraj modele i analitiku
Konačna unakrsna referenca je ono što pokreće odluku: s jedne strane koliko svaki model košta, s druge strane koliko ga koristiš. Skup i marginalan model ne zaslužuje pažnju; skup model koji apsorbira većinu tvojih zahtjeva prvi je kandidat za promjenu, a ovo je upravo ono što ova skripta iznosi na vidjelo u jednom retku.
# 1. Popis dostupnih modela
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Analiza korištenja po 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. Usporedba
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'Dostupni modeli koji se ne koriste: {unused}')
"
Cijene od 5. kolovoza 2026. — cijene se redovito mijenjaju: prije bilo kakvog izračuna proračuna, provjeri trenutnu tarifu na službenoj stranici xAI modela i cijena.
Ključne točke
GET /auth/teams/{teamId}/modelsizlistava modele s cijenama i mogućnostimaGET /auth/teams/{teamId}/endpointsizlistava krajnje točke za ACL-ove- Koristi ove informacije za stvaranje API ključeva s preciznim ACL-ovima
- Usporedi stope kako bi odabrao najekonomičniji model prilagođen tvojoj upotrebi
- Redovito prati nove dostupne modele