Modele disponibile
Pe această pagină
Descoperiți modelele disponibile
Acest endpoint răspunde unei întrebări pe care ați putea presupune în mod eronat că o puteți gestiona din memorie: care sunt modelele pe care echipa dumneavoastră le poate apela efectiv și la ce preț astăzi. Documentația publică descrie catalogul general; API-ul descrie catalogul dumneavoastră, inclusiv prețurile curente.
Decalajul dintre cele două nu este teoretic. Nivelurile evoluează, prețurile se modifică, iar un ID copiat dintr-un articol de blog vechi de șase luni produce o eroare de acces greu de diagnosticat. Faceți din interogarea acestui endpoint un obicei, în loc să presupuneți – aceasta este și metoda care menține fiabilitatea scripturilor dumneavoastră de comparare a costurilor în timp. Aceste informații sunt esențiale pentru a alege modelul potrivit pentru cazul dumneavoastră de utilizare și buget.
Listarea modelelor
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Răspunsul conține pentru fiecare model:
- ID: numele exact de utilizat în apelurile API (ex:
grok-4.20-0309-reasoning) - Cluster: grupul de servere care găzduiește modelul
- Pricing: prețul per milion de tokeni pentru intrare și ieșire
- Capabilities: dimensiunea contextului, suport multimodal etc.
Utilizare în gestionarea cheilor
Aici devine endpoint-ul indispensabil, nu doar practic. O listă de control al accesului (ACL) care numește un model inexistent – deoarece formatul ID-ului s-a schimbat sau modelul a fost retras – nu generează o eroare evidentă: pur și simplu nu autorizează nimic, iar dumneavoastră ajungeți să căutați eroarea în codul dumneavoastră. Verificați ID-ul la sursă înainte de a-l bloca într-o cheie.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Dacă restricționați o cheie la modele specifice, verificați mai întâi dacă acestea sunt disponibile echipei dumneavoastră prin intermediul acestui endpoint.
Listarea endpoint-urilor ACL
Aceeași logică se aplică endpoint-urilor: lista de mai jos este cea autorizată pentru compunerea ACL-urilor dumneavoastră. Aceasta oferă, de asemenea, o vizualizare utilă a domeniului de aplicare real al unei chei – o cheie limitată la chat nu poate genera nici embedding-uri, nici procesa imagini, indiferent de modelele la care face altfel referință.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Endpoint-urile disponibile sunt:
- chat: conversații text (completări chat)
- embed: generare de embedding-uri
- image: generare și analiză de imagini
- models: listă de modele
- sample: eșantionare
- tokenize: tokenizare text
- documents: procesare documente
Alegerea modelului potrivit
După cazul de utilizare
| Caz de utilizare | Model recomandat | De ce |
|---|---|---|
| Raționament complex | grok-4.20-0309-reasoning | Lanț avansat de gândire |
| Sarcini simple, volum mare | grok-4.3 | Rapid, economic |
| Analiză de imagini | Model multimodal | Suport pentru viziune |
| Embeddings / RAG | Model de embedding | Optimizat pentru căutare |
După buget
Comparați tarifele returnate de API, nu pe cele pe care le aveți în minte. Logica de arbitraj este întotdeauna aceeași: o sarcină de clasificare sau extracție nu beneficiază de un model de raționament, totuși îi plătiți prețul la fiecare apel – iar acesta este exact tipul de sarcină pe care îl executați de mii de ori. Modelul de raționament este necesar pentru analize complexe.
Script de comparare a modelelor
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Recuperare 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} {'Input ($/M)':<15} {'Output ($/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}")
Monitorizarea noilor modele
Catalogul se modifică de mai multe ori pe an, iar cele mai interesante schimbări nu sunt noile modele, ci scăderile de preț la cele vechi. O verificare periodică care compară cu înregistrarea anterioară semnalează ambele situații și costă doar câteva linii de cod într-un cron.
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"
# Recuperare modele curente
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", [])}
# Comparare cu cache-ul
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"New models: {', '.join(new_models)}")
if removed_models:
print(f"Removed models: {', '.join(removed_models)}")
# Actualizare cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Combinarea modelelor și a analiticilor
Referința încrucișată finală este cea care conduce decizia: pe de o parte, cât costă fiecare model, pe de altă parte, cât îl utilizați. Un model scump și marginal nu merită atenție; un model scump care absoarbe grosul cererilor dumneavoastră este primul candidat pentru o schimbare, iar acesta este exact ceea ce scoate la iveală acest script într-o singură linie.
# 1. Listarea modelelor disponibile
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Analiza utilizării pe model
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. Comparare
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'Available models not used: {unused}')
"
Prețuri valabile la 5 august 2026 — prețurile evoluează regulat: înainte de orice calcul bugetar, verificați grila curentă pe pagina oficială xAI pentru modele și prețuri.
Puncte cheie
GET /auth/teams/{teamId}/modelslistează modelele cu prețuri și capacitățiGET /auth/teams/{teamId}/endpointslistează endpoint-urile pentru ACL-uri- Utilizați aceste informații pentru a crea chei API cu ACL-uri precise
- Comparați tarifele pentru a alege modelul cel mai economic adaptat utilizării dumneavoastră
- Monitorizați regulat noile modele disponibile