Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Mudelli Disponibbli

Lezzjoni 12 / 14 Aġġornat 29 ta’ Lulju 2026 Zviluppatur
F'din il-paġna
  1. Skopri l-mudelli disponibbli
  2. Elenska l-mudelli
  3. Użu fil-ġestjoni taċ-ċwievet
  4. Elenska l-endpoints tal-ACL
  5. Agħżel il-mudell it-tajjeb
  6. Skript għat-tqabbil tal-mudelli
  7. Monitoraġġ ta’ mudelli ġodda
  8. Għaqqad il-mudelli u l-analitika
  9. Punti Ewlenin

Skopri l-mudelli disponibbli

Dan l-endpoint iwieġeb mistoqsija li tista’ taħseb b’mod żbaljat li taf biż-żekr: liema mudelli it-tim tiegħek jista’ effettivament isejjaħ, u bi prezz kemm illum. Id-dokumentazzjoni pubblika tiddeskrivi l-katalgu ġenerali; l-API tiddeskrivi l-katalgu tiegħek, inkluż l-ipprezzar attwali.

Id-diverġenza bejn iż-żewġ naħat mhix teoretika. Il-livelli jevolvu, il-prezzijiet jinbidlu, u ID ikkupjat minn artiklu tal-blog ta’ sitt xhur ilu jipproduċi żball ta’ aċċess diffiċli biex tiddijanostikah. Agħmilha drawwa li tistaqsi dan l-endpoint minflok ma tassumi—hija wkoll dak li jżomm l-iskrits tiegħek għat-tqabbil tal-ispejjeż affidabbli maż-żmien. Din l-informazzjoni hija essenzjali biex tagħżel il-mudell it-tajjeb għall-każ ta’ użu u l-baġit tiegħek.

Elenska l-mudelli

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

Ir-risposta fiha għal kull mudell:

  • ID: l-isem eżatt li għandu jintuża f’sejħiet tal-API (eż: grok-4.20-0309-reasoning)
  • Cluster: il-grupp ta’ servers li jospita l-mudell
  • Pricing: il-prezz għal kull miljun token għall-input u l-output
  • Capabilities: id-daqs tal-kuntest, appoġġ multimodali, eċċ.

Użu fil-ġestjoni taċ-ċwievet

Hawnhekk fejn l-endpoint isir indispensabbli minflok sempliċiment prattiku. ACL li ssemmi mudell li ma jeżistix—għax il-format tal-ID inbidel jew il-mudell ġie rtirat—ma jfallix b’mod evidenti: sempliċiment ma jawtorizza xejn, u tispiċċa tfittex l-iżball fil-kodiċi tiegħek. Ivvverifika l-ID fis-sors qabel ma tissakrah f’ċavetta.

{
  "acls": [
    "api-key:model:grok-4.20-0309-reasoning",
    "api-key:model:grok-4.3"
  ]
}

Jekk tirrestrinġi ċavetta għal mudelli speċifiċi, ivverifika l-ewwel li huma disponibbli għat-tim tiegħek permezz ta’ dan l-endpoint.

Elenska l-endpoints tal-ACL

L-istess loġika tapplika għall-endpoints: il-lista hawn taħt hija dik awtoritattiva għall-kompożizzjoni tal-ACLs tiegħek. Tipprovdi wkoll veduta utli tal-ambitu attwali ta’ ċavetta—ċavetta limitata għal chat la tista’ tiġġenera embeddings u lanqas tipproċessa stampi, irrispettivament mill-mudelli li tirreferi għalihom mod ieħor.

curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY"

L-endpoints disponibbli huma:

  • chat: konversazzjonijiet tat-test (chat completions)
  • embed: ġenerazzjoni ta’ embeddings
  • image: ġenerazzjoni u analiżi tal-immaġni
  • models: lista tal-mudelli
  • sample: kampjunar (sampling)
  • tokenize: tokenizzazzjoni tat-test
  • documents: ipproċessar tad-dokumenti

Agħżel il-mudell it-tajjeb

Skont il-każ ta’ użu

Każ ta’ użuMudell rakkomandatGħaliex
Raġunament kumplessgrok-4.20-0309-reasoningKatina avvanzata ta’ ħsieb
Kompiti sempliċi, volum għoligrok-4.3Mgħaġġel, ekonomiku
Analiżi tal-immaġniMudell multimodaliAppoġġ tal-viżjoni
Embeddings / RAGMudell tal-embedOttimizzat għat-tfittxija

Skont il-baġit

Qabbel ir-rati rritornati mill-API minflok dawk li għandek f’moħħok. Il-loġika tal-arbitraġġ hija dejjem l-istess: kompitu ta’ klassifikazzjoni jew estrazzjoni ma jibbenefikax minn mudell tar-raġunament, madankollu tħallas il-prezz tiegħu fuq kull sejħa—u dan huwa preċiżament it-tip ta’ kompitu li tmexxi eluf ta’ drabi. Il-mudell tar-raġunament huwa meħtieġ għal analiżijiet kumplessi.

Skript għat-tqabbil tal-mudelli

import requests
import json

MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."

# Irkupra l-mudelli
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}")

Monitoraġġ ta’ mudelli ġodda

Il-katalgu jinbidel diversi drabi fis-sena, u l-bidliet l-aktar interessanti mhumiex mudelli ġodda iżda tnaqqis fil-prezz fuq dawk antiki. Verifika perjodika li tqabbel mar-rekord preċedenti tifflegja t-tnejn, u tiswew ftit linji ta’ 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"

# Irkupra l-mudelli attwali
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", [])}

# Qabbel mal-cache
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"Mudelli ġodda: {', '.join(new_models)}")
    if removed_models:
        print(f"Mudelli mneħħija: {', '.join(removed_models)}")

# Aġġorna l-cache
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Għaqqad il-mudelli u l-analitika

Ir-referenza incroċjata finali hija dik li tmexxi d-deċiżjoni: minn naħa kemm jiswa kull mudell, u min-naħa l-oħra kemm tużah. Mudell għali u marġinali ma jistħoqqilux attenzjoni; mudell għali li jassorbi l-biċċa l-kbira tat-talbiet tiegħek huwa l-ewwel kandidat għal bidla, u dan huwa eżattament dak li dan l-iskript jiġbed fid-dieher f’linja waħda.

# 1. Elenska l-mudelli disponibbli
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analizza l-użu skont il-mudell
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. Qabbel
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'Mudelli disponibbli mhux użati: {unused}')
"

Ipprezzar sal-5 ta’ Awwissu 2026 — il-prezzijiet jevolvu regolarment: qabel kwalunkwe kalkolu tal-baġit, ivverifika l-grilja attwali fuq il-paġna uffiċjali tal-mudelli u l-ipprezzar ta’ xAI.

Punti Ewlenin

  • GET /auth/teams/{teamId}/models jelenka l-mudelli bl-ipprezzar u l-kapaċitajiet
  • GET /auth/teams/{teamId}/endpoints jelenka l-endpoints għall-ACLs
  • Uża din l-informazzjoni biex toħloq ċwievet tal-API b’ACLs preċiżi
  • Qabbel ir-rati biex tagħżel il-mudell l-aktar ekonomiku adattat għall-użu tiegħek
  • Monitora regolarment il-mudelli ġodda disponibbli