Salt la conținutul principal
Română— Alege o limbă
Meniu

Modele disponibile

Lecția 12 din 14 Actualizată 29 iulie 2026 Dezvoltator
Pe această pagină
  1. Descoperiți modelele disponibile
  2. Listarea modelelor
  3. Utilizare în gestionarea cheilor
  4. Listarea endpoint-urilor ACL
  5. Alegerea modelului potrivit
  6. Script de comparare a modelelor
  7. Monitorizarea noilor modele
  8. Combinarea modelelor și a analiticilor
  9. Puncte cheie

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 utilizareModel recomandatDe ce
Raționament complexgrok-4.20-0309-reasoningLanț avansat de gândire
Sarcini simple, volum maregrok-4.3Rapid, economic
Analiză de imaginiModel multimodalSuport pentru viziune
Embeddings / RAGModel de embeddingOptimizat 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}/models listează modelele cu prețuri și capacități
  • GET /auth/teams/{teamId}/endpoints listează 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