Käytettävissä olevat mallit
Tällä sivulla
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ötarkoitus | Suositeltu malli | Miksi |
|---|---|---|
| Monimutkainen päättely | grok-4.20-0309-reasoning | Edistynyt ajatusketju |
| Yksinkertaiset tehtävät, suuri volyymi | grok-4.3 | Nopea, taloudellinen |
| Kuvien analyysi | Multimodaalimalli | Näkökykytuki |
| Upotukset / RAG | Upotusmalli | Optimoitu 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}/modelslistaa mallit hinnoittelun ja ominaisuuksien keraGET /auth/teams/{teamId}/endpointslistaa 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