Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Saadaolevad mudelid

Õppetund 12 / 14 Värskendatud 29. juuli 2026 Arendajatele
Sellel lehel
  1. Avasta saadaolevad mudelid
  2. Mudelite loetelu
  3. Kasutamine võtmehalduses
  4. ACL-i lõpp-punktide loetelu
  5. Vali õige mudel
  6. Mudelite võrdlusskript
  7. Jälgi uusi mudeleid
  8. Kombineeri mudelid ja analüütika
  9. Peamised punktid

Avasta saadaolevad mudelid

See lõpp-punkt vastab küsimusele, mida võid ekslikult pidada peast teada olevaks: milliseid mudeleid sinu meeskond tegelikult kasutada saab ja mis on nende tänane hind. Avalik dokumentatsioon kirjeldab üldist kataloogi; API kirjeldab sinu kataloogi, sealhulgas kehtivaid hindu.

Lünk nende kahe vahel pole teoreetiline. Tasemed muutuvad, hinnad kõiguvad ja kuue kuu tagusest blogipostitusest kopeeritud ID põhjustab raskesti diagnoositava juurdepääsuvea. Harjumuseks peaks saama selle lõpp-punkti päringute tegemine eelduste asemel – just see hoiab sinu kulude võrdlusskriptid aja jooksul töökindlatena. See teave on hädavajalik õige mudeli valimiseks vastavalt sinu kasutusjuhtumile ja eelarvele.

Mudelite loetelu

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

Vastus sisaldab iga mudeli kohta:

  • ID: täpne nimi, mida kasutada API väljakutsetes (nt grok-4.20-0309-reasoning)
  • Klastri: serverirühm, kus mudelit hostitakse
  • Hinnakiri: hind miljoni tokeni kohta sisendi ja väljundi jaoks
  • Võimekused: konteksti suurus, multimoodne tugi jne.

Kasutamine võtmehalduses

Siin muutub see lõpp-punkt mitte lihtsalt praktiliseks, vaid asendamatuks. ACL, mis viitab olematule mudelile – kuna ID vorming muutus või mudel retireeriti – ei põhjusta kohest veateadet: see lihtsalt ei autoriseeri midagi ja lõpuks otsid viga oma koodist. Kontrolli ID-d allikast enne, kui lukustad selle võtmesse.

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

Kui piirad võtit kindlate mudelitega, veendu esmalt selle lõpp-punkti kaudu, et need on sinu meeskonnale saadaval.

ACL-i lõpp-punktide loetelu

Sama loogika kehtib lõpp-punktide kohta: allpool olev loetelu on autoriteetne allikas sinu ACL-ide koostamiseks. See annab ka kasuliku ülevaate võtme tegelikust ulatusest – võti, mis on piiratud ainult chat-iga, ei saa genereerida manuseid ega töödelda pilte, sõltumata mudelitest, millele see viitab.

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

Saadaolevad lõpp-punktid on:

  • chat: tekstivestlused (chat completions)
  • embed: manuste genereerimine
  • image: piltide genereerimine ja analüüs
  • models: mudelite loetelu
  • sample: valimimine (sampling)
  • tokenize: teksti tokeniseerimine
  • documents: dokumentide töötlemine

Vali õige mudel

Kasutusjuhtumi järgi

KasutusjuhtumSoovitatav mudelMiks
Kompleksne arutluskäikgrok-4.20-0309-reasoningTäiustatud mõtteahel
Lihtsad ülesanded, suur mahtgrok-4.3Kiire, ökonoomne
Piltide analüüsMultimoodne mudelNägemise tugi
Manused / RAGEmbed mudelOtsinguks optimeeritud

Eelarve järgi

Võrdle API tagastatud hindu, mitte neid, mis sul meeles on. Arbitraaži loogika on alati sama: klassifitseerimis- või ekstraktsiooniülesanne ei saa kasu arutlusmudelist, ometi maksad iga väljakutse eest selle hinda – ja just selliseid ülesandeid käivitad tuhandeid kordi. Arutlusmudel on vajalik kompleksseteks analüüsideks.

Mudelite võrdlusskript

import requests
import json

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

# Hangi mudelid
response = requests.get(
    f"{MANAGEMENT_API}/auth/teams/{TEAM_ID}/models",
    headers={"Authorization": f"Bearer {MGMT_KEY}"}
)

models = response.json().get("models", [])

print(f"{'Mudel':<35} {'Sisend ($/M)':<15} {'Väljund ($/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}")

Jälgi uusi mudeleid

Kataloog muutub mitu korda aastas ja kõige huvitavamad muutused ei ole uued mudelid, vaid vanade hindade langus. Perioodiline kontroll, mis võrdleb tulemusi eelmise salvestusega, tuvastab mõlemad ja maksab vaid paar rida cron-i koodi.

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"

# Hangi praegused mudelid
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", [])}

# Võrdle vahemäluga
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"Uued mudelid: {', '.join(new_models)}")
    if removed_models:
        print(f"Eemaldatud mudelid: {', '.join(removed_models)}")

# Uuenda vahemälu
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Kombineeri mudelid ja analüütika

Lõplik ristviide on see, mis suunab otsust: ühel pool iga mudeli hind, teisel pool selle kasutusmaht. Kallis ja marginaalne mudel ei vääri tähelepanu; kallis mudel, mis neelab suure osa sinu päringutest, on esimene kandidaat muutmiseks ja just seda toob see skript ühe reaga esile.

# 1. Loetle saadaolevad mudelid
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analüüsi kasutust mudeli järgi
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. Võrdle
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'Kasutamata saadaolevad mudelid: {unused}')
"

Hinnad seisuga 5. august 2026 – hinnad muutuvad regulaarselt: enne eelarve arvutamist kontrolli kehtivat hinnakirja xAI ametlikul mudelite ja hindade lehel.

Peamised punktid

  • GET /auth/teams/{teamId}/models loetleb mudelid koos hindade ja võimekustega
  • GET /auth/teams/{teamId}/endpoints loetleb lõpp-punktid ACL-ide jaoks
  • Kasuta seda teavet täpsete ACL-idega API-võtmete loomiseks
  • Võrdle hindu, et valida sinu kasutusele kõige ökonoomsem mudel
  • Jälgi regulaarselt uusi saadaolevaid mudeleid