Премини към основното съдържание
Български— Изберете език
Меню

Налични модели

Урок 12 от 14 Обновен 29 юли 2026 г. Програмист
На тази страница
  1. Откриване на наличните модели
  2. Списък с модели
  3. Използване при управлението на ключове
  4. Списък с крайни точки за ACL
  5. Избор на правилния модел
  6. Скрипт за сравнение на модели
  7. Мониторинг на нови модели
  8. Комбиниране на модели и аналитика
  9. Ключови изводи

Откриване на наличните модели

Тази крайна точка отговаря на въпрос, който може погрешно да приемете, че можете да решите от паметта си: кои модели Вашият екип може действително да извиква и на каква цена днес. Публичната документация описва общия каталог; 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Бърз, икономичен
Анализ на изображенияМултимодален моделПоддръжка на зрение
Вграждания / RAGEmbed моделОптимизиран за търсене

Според бюджета

Сравнете тарифите, върнати от 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
  • Сравнете тарифите, за да изберете най-икономичния модел, подходящ за Вашето използване
  • Редовно следете новите налични модели