Налични модели
На тази страница
Откриване на наличните модели
Тази крайна точка отговаря на въпрос, който може погрешно да приемете, че можете да решите от паметта си: кои модели Вашият екип може действително да извиква и на каква цена днес. Публичната документация описва общия каталог; API описва Вашия каталог, включително текущите цени.
Разликата между двете не е теоретична. Нивата се променят, цените се изместват и ID, копирано от блог пост преди шест месеца, води до грешка при достъп, която е трудна за диагностициране. Направете си навик да заявявате тази крайна точка, вместо да правите предположения – това също така поддържа скриптовете Ви за сравнение на разходите надеждни във времето. Тази информация е от съществено значение за избора на правилния модел за Вашия случай на употреба и бюджет.
Списък с модели
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Отговорът съдържа за всеки модел:
- ID: точното име за използване в API повикванията (напр.:
grok-4.20-0309-reasoning) - Cluster: групата сървъри, хостваща модела
- Pricing: цена на милион токена за вход и изход
- Capabilities: размер на контекста, мултимодална поддръжка и др.
Използване при управлението на ключове
Тук крайната точка става незаменима, а не просто практична. ACL (списък за контрол на достъпа), който посочва несъществуващ модел – защото форматът на ID се е променил или моделът е пенсиониран – не генерира ясна грешка: той просто не разрешава нищо и Вие завършвате с търсене на грешката във Вашия код. Проверете ID в източника, преди да го заключите в ключ.
{
"acls": [
"api-key:model:grok-4.20-0309-reasoning",
"api-key:model:grok-4.3"
]
}
Ако ограничите ключ до конкретни модели, първо проверете дали те са налични за Вашия екип чрез тази крайна точка.
Списък с крайни точки за ACL
Същата логика важи и за крайните точки: списъкът по-долу е авторитетният източник за съставяне на Вашите ACL. Той също така предоставя полезен изглед на действителния обхват на ключа – ключ, ограничен до chat, не може нито да генерира вграждания (embeddings), нито да обработва изображения, независимо от моделите, към които иначе се отнася.
curl "https://management-api.x.ai/auth/teams/$TEAM_ID/endpoints" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY"
Наличните крайни точки са:
- chat: текстови разговори (chat completions)
- embed: генериране на вграждания
- image: генериране и анализ на изображения
- models: списък с модели
- sample: семплиране
- tokenize: токенизация на текст
- documents: обработка на документи
Избор на правилния модел
Според случая на употреба
| Случай на употреба | Препоръчителен модел | Защо |
|---|---|---|
| Сложно разсъждение | grok-4.20-0309-reasoning | Разширена верига от мисли |
| Прости задачи, висок обем | grok-4.3 | Бърз, икономичен |
| Анализ на изображения | Мултимодален модел | Поддръжка на зрение |
| Вграждания / RAG | Embed модел | Оптимизиран за търсене |
Според бюджета
Сравнете тарифите, върнати от API, а не тези, които имате предвид. Логиката на арбитража винаги е една и съща: задача за класификация или извличане не получава полза от модел за разсъждение, въпреки че плащате неговата цена при всяко повикване – а това е точно типът задача, който изпълнявате хиляди пъти. Моделът за разсъждение е необходим за сложни анализи.
Скрипт за сравнение на модели
import requests
import json
MANAGEMENT_API = "https://management-api.x.ai"
MGMT_KEY = "xai-mgmt-..."
TEAM_ID = "team-..."
# Retrieve models
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}")
Мониторинг на нови модели
Каталогът се променя няколко пъти годишно и най-интересните промени не са новите модели, а спадовете в цените на старите. Периодична проверка, която сравнява с предишния запис, открива и двете, а струва само няколко реда в 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"
# Retrieve current models
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", [])}
# Compare with 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"New models: {', '.join(new_models)}")
if removed_models:
print(f"Removed models: {', '.join(removed_models)}")
# Update cache
with open(CACHE_FILE, "w") as f:
json.dump(list(current_models), f)
Комбиниране на модели и аналитика
Крайното кръстосано позоваване е това, което движи решението: от една страна колко струва всеки модел, от друга – колко го използвате. Скъп и маргинален модел не заслужава внимание; скъп модел, който поглъща по-голямата част от Вашите заявки, е първият кандидат за промяна и точно това този скрипт изкарва наяве с един ред.
# 1. List available models
curl -s "https://management-api.x.ai/auth/teams/$TEAM_ID/models" \
-H "Authorization: Bearer $MANAGEMENT_API_KEY" > /tmp/models.json
# 2. Analyze usage by model
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. Compare
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'Available models not used: {unused}')
"
Цени към 5 август 2026 г. – цените се променят редовно: преди всяко изчисление на бюджета проверете текущата тарифа на официалната страница за модели и цени на xAI.
Ключови изводи
GET /auth/teams/{teamId}/modelsизброява моделите с цени и възможностиGET /auth/teams/{teamId}/endpointsизброява крайните точки за ACL- Използвайте тази информация, за да създадете API ключове с точни ACL
- Сравнете тарифите, за да изберете най-икономичния модел, подходящ за Вашето използване
- Редовно следете новите налични модели