Saadaolevad mudelid
Sellel lehel
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
| Kasutusjuhtum | Soovitatav mudel | Miks |
|---|---|---|
| Kompleksne arutluskäik | grok-4.20-0309-reasoning | Täiustatud mõtteahel |
| Lihtsad ülesanded, suur maht | grok-4.3 | Kiire, ökonoomne |
| Piltide analüüs | Multimoodne mudel | Nägemise tugi |
| Manused / RAG | Embed mudel | Otsinguks 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}/modelsloetleb mudelid koos hindade ja võimekustegaGET /auth/teams/{teamId}/endpointsloetleb 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