Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Käytettävissä olevat mallit

Oppitunti 12 / 14 Päivitetty 29. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Tutustu käytettävissä oleviin malleihin
  2. Listaa mallit
  3. Käyttö avainten hallinnassa
  4. Listaa ACL-päätepisteet
  5. Valitse oikea malli
  6. Mallien vertailuskripti
  7. Seuraa uusia malleja
  8. Yhdistä mallit ja analytiikka
  9. Keskeiset asiat

Tutustu käytettävissä oleviin malleihin

Tämä päätepiste vastaa kysymykseen, jonka saatat erehdyksessä luulla pystyväsi hoitamaan muistisi varassa: mitkä mallit tiimisi voi todella kutsua ja millä hinnalla juuri tänään. Julkiset dokumentit kuvaavat yleistä luetteloa; API kuvaa sinun luetteloasi, nykyiset hinnoittelut mukaan lukien.

Näiden kahden välinen kuilu ei ole teoreettinen. Tasot kehittyvät, hinnat muuttuvat, ja kuusi kuukautta vanhasta blogikirjoituksesta kopioitu tunnus tuottaa vaikeasti diagnosoitavan käyttövirheen. Tee tavaksi kysyä tätä päätepistettä oletusten sijaan – se on myös se, mikä pitää kustannusvertailuskriptisi luotettavina ajan myötä. Nämä tiedot ovat välttämättömiä oikean mallin valitsemiseksi käyttötarkoitukseesi ja budjettiisi.

Listaa mallit

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

Vastaus sisältää jokaiselle mallille:

  • Tunnus (ID): tarkka nimi, jota käytetään API-kutsuissa (esim. grok-4.20-0309-reasoning)
  • Klusteri: palvelinryhmä, joka isännöi mallia
  • Hinnoittelu: hinta miljoonaa tokenia kohden syötteelle ja tulosteelle
  • Ominaisuudet: kontekstin koko, multimodaalituki jne.

Käyttö avainten hallinnassa

Tässä kohdassa päätepisteestä tulee välttämätön pelkän käytännöllisyyden sijaan. ACL, joka nimeää olemattoman mallin – koska tunnusmuoto on muuttunut tai malli on poistettu käytöstä – ei epäonnistu äänekkäästi: se vain valtuuttaa ei-mitään, ja päädyt etsimään virhettä koodistasi. Varmista tunnus lähteellä ennen kuin lukitset sen avaimeen.

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

Jos rajoitat avaimen tiettyihin malleihin, varmista ensin tämän päätepisteen avulla, että ne ovat tiimisi käytettävissä.

Listaa ACL-päätepisteet

Sama logiikka pätee päätepisteisiin: alla oleva lista on auktoritatiivinen lähde ACL-koostelmillesi. Se tarjoaa myös hyödyllisen näkymän avaimen todelliseen laajuuteen – avain, joka on rajoitettu vain chat-toimintoon, ei voi generoida upotuksia eikä käsitellä kuvia, riippumatta muista viittaamistaan malleista.

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

Käytettävissä olevat päätepisteet ovat:

  • chat: tekstikeskustelut (chat-täydennykset)
  • embed: upotusten generointi
  • image: kuvien generointi ja analyysi
  • models: malliluettelo
  • sample: otannan suoritus
  • tokenize: tekstin tokenisointi
  • documents: dokumenttien käsittely

Valitse oikea malli

Käyttötarkoituksen mukaan

KäyttötarkoitusSuositeltu malliMiksi
Monimutkainen päättelygrok-4.20-0309-reasoningEdistynyt ajatusketju
Yksinkertaiset tehtävät, suuri volyymigrok-4.3Nopea, taloudellinen
Kuvien analyysiMultimodaalimalliNäkökykytuki
Upotukset / RAGUpotusmalliOptimoitu hakuun

Budjetin mukaan

Vertaa API:n palauttamia hintoja niihin, jotka sinulla on mielessäsi. Arbitraasilogiikka on aina sama: luokittelu- tai ekstraktiotehtävä ei hyödy päättelymallista, mutta maksat sen hinnan jokaisesta kutsusta – ja juuri tämäntyyppisiä tehtäviä ajat tuhansia kertoja. Päättelymalli on välttämätön monimutkaisiin analyyseihin.

Mallien vertailuskripti

import requests
import json

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

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

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

print(f"{'Malli':<35} {'Syöte ($/M)':<15} {'Tuloste ($/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}")

Seuraa uusia malleja

Luettelo muuttuu useita kertoja vuodessa, ja kiinnostavimmat muutokset eivät ole uusia malleja, vaan vanhojen hintalaskuja. Säännöllinen tarkistus, joka vertaa tuloksia edelliseen tallenteeseen, merkitsee molemmat, ja maksaa vain muutaman rivin cron-tehtävänä.

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"

# Hae nykyiset mallit
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", [])}

# Vertaa välimuistiin
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"Uudet mallit: {', '.join(new_models)}")
    if removed_models:
        print(f"Poistetut mallit: {', '.join(removed_models)}")

# Päivitä välimuisti
with open(CACHE_FILE, "w") as f:
    json.dump(list(current_models), f)

Yhdistä mallit ja analytiikka

Lopullinen ristiviittaus on se, joka ohjaa päätöstä: toisella puolella on kunkin mallin hinta, toisella sen käyttömäärä. Kallis ja marginaalinen malli ei ansaitse huomiota; kallis malli, joka nielee suurimman osan pyynnöistäsi, on ensimmäinen ehdokas muutokselle, ja juuri tämän tämä skripti tuo esiin yhdellä rivillä.

# 1. Listaa käytettävissä olevat mallit
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
  -H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json

# 2. Analysoi käyttöä mallin mukaan
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. Vertaa
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'Käyttämättömät käytettävissä olevat mallit: {unused}')
"

Hinnoittelu 5. elokuuta 2026 – hinnat muuttuvat säännöllisesti: ennen kuin teet minkäänlaisia budjettilaskelmia, varmista nykyinen hinnasto xAI:n viralliselta mallit ja hinnoittelu -sivulta.

Keskeiset asiat

  • GET /auth/teams/{teamId}/models listaa mallit hinnoittelun ja ominaisuuksien kera
  • GET /auth/teams/{teamId}/endpoints listaa päätepisteet ACL:iä varten
  • Käytä näitä tietoja luodaksesi API-avaimia tarkkojen ACL-sääntöjen kanssa
  • Vertaa hintoja valitaksesi käyttöösi sopivimman ja taloudellisimman mallin
  • Seuraa säännöllisesti uusia käytettävissä olevia malleja