Модели

Каталог AI Gateway помогает решить две разные задачи: получить короткий список доступных model ID через API и выбрать подходящую модель, цену, путь и поставщика в интерфейсе. Для программного списка используйте GET /v1/models, а подробности смотрите в разделе Модели и на странице цен.

Важно не смешивать эти источники. Ответ GET /v1/models намеренно минимален: в нём нет цен, размера контекста, описания архитектуры, перечня возможностей и строк поставщиков.

Каталог моделей

В AI Gateway есть два представления каталога:

• GET https://route.smartaipack.ru/v1/models — OpenAI-совместимый список идентификаторов, доступных по вашему ключу;
• Модели в кабинете и публичная страница цен — подробное представление для выбора модели и маршрута.

Начинайте с интерфейса, если сравниваете стоимость, контекст, поддерживаемые пути или возможности. Обращайтесь к API, если приложению нужно проверить доступные идентификаторы автоматически.

Список меняется вместе с опубликованным каталогом AI Gateway. Поэтому не переносите идентификатор из чужой документации и не сокращайте его вручную: копируйте значение из актуального каталога.

GET /v1/models

Запрос требует действующий ключ AI Gateway в заголовке Authorization:

curl https://route.smartaipack.ru/v1/models \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY"

Успешный ответ имеет такой вид:

{
  "object": "list",
  "revision_id": "<ID_ОПУБЛИКОВАННОЙ_РЕВИЗИИ>",
  "data": [
    {
      "id": "gpt-5.5",
      "object": "model",
      "created": 1787356800,
      "owned_by": "gateway"
    }
  ]
}

Поле created в примере соответствует началу 22 августа 2026 года по UTC и показано только для иллюстрации формата. Это пример формы ответа, а не обещание наличия конкретной модели или точного времени публикации каталога. Актуальные значения находятся в data вашего ответа. У этого запроса не описаны параметры фильтрации или сортировки, а отдельного публичного запроса для одной модели в этом руководстве нет.

Формат ответа API

Корневой объект

revision_id — служебное поле версии каталога. Его не нужно передавать в запрос генерации вместо model.

Объект модели

В объекте модели нет цены, контекстного окна, списка путей или возможностей. Не пытайтесь вычислять их по id или owned_by.

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

Подробный каталог нужен до начала интеграции и при смене модели. В кабинете модели сгруппированы по разработчику; строку можно раскрыть, чтобы увидеть варианты поставщиков, точные идентификаторы и поддерживаемые пути. На странице цен доступно публичное сравнение моделей.

Архитектура и контекст

У каталога AI Gateway нет универсального текстового поля architecture в ответе GET /v1/models. Для практического выбора ориентируйтесь на разработчика и семейство модели, размер контекстного окна и поддерживаемые виды входных данных в подробном каталоге.

Контекст показывает максимальный объём данных, который модель может учитывать в одном запросе. Сравнивайте его на странице цен, если работаете с длинными документами, историей диалога или большим фрагментом кода. Больший контекст сам по себе не гарантирует более подходящий ответ: учитывайте также цену и возможности нужного маршрута.

Цены

Цены указаны в рублях за 1 млн токенов отдельно для входа и выхода. Если у модели несколько маршрутов, в свёрнутой строке может быть показана минимальная цена с пометкой «от», а после раскрытия — цена конкретного поставщика.

Сравнивайте цену именно того маршрута, который собираетесь вызывать. Кеширование и рассуждение могут тарифицироваться отдельно, если такие компоненты опубликованы для модели. Актуальные значения всегда проверяйте на странице цен.

Поставщики и маршруты

Одна модель может быть доступна у нескольких поставщиков и через разные пути, например /v1/chat/completions или /v1/messages. В раскрытой строке поставщика указаны:

• его точный request_model_id, который можно скопировать;
• поддерживаемые пути API;
• цены этого варианта;
• возможности именно этого маршрута.

Маршрут выбирается сочетанием пути запроса и значения model. Поэтому один и тот же bare model ID может иметь разные маршруты по умолчанию на разных путях.

Поддерживаемые возможности

В подробном каталоге отдельно отмечены текст, изображения, вызов инструментов и рассуждение. Если у модели несколько поставщиков, набор возможностей может зависеть от выбранного варианта.

Проверяйте возможности в строке поставщика, а не только в общей строке модели. Например, маршрут mie/* не публикуется как поддерживающий вызов инструментов и рассуждение, а /v1/messages для него не поддерживается.

Как выбрать точный model ID

Есть два способа указать модель:

1. Bare model ID, например claude-sonnet-4-6. Он сохраняет маршрут AI Gateway по умолчанию для выбранного пути.
2. Точный request_model_id поставщика, например mie/claude-sonnet-4-6 или anthropic/claude-sonnet-4-6. Он закрепляет запрос за конкретным вариантом из каталога.

Если вам подходит маршрут по умолчанию, скопируйте bare model ID из общей строки. Если важны конкретная цена, путь или набор возможностей, раскройте модель и скопируйте request_model_id из строки нужного поставщика.

Явно выбранный поставщик не заменяется другим при ошибке. Это защищает предсказуемость цены и поведения: запрос либо выполняется выбранным маршрутом, либо возвращает ошибку. В частности, mie/claude-sonnet-4-6 следует отправлять на /v1/chat/completions, а не на /v1/messages.

Как проверить модель запросом

Сначала убедитесь, что нужный id присутствует в ответе GET /v1/models. Затем проверьте точный путь в каталоге моделей и отправьте короткий запрос. Для модели, поддерживающей /v1/chat/completions, проверка выглядит так:

curl https://route.smartaipack.ru/v1/chat/completions \
  -H "Authorization: Bearer $AI_GATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [
      {
        "role": "user",
        "content": "Ответь одним словом: работает?"
      }
    ]
  }'

Замените gpt-5.5 на точный идентификатор из своего каталога. Если запрос не проходит, последовательно проверьте:

• ключ передан как Bearer и остаётся активным;
• значение model скопировано без сокращений и переименований;
• выбранный путь указан у этого поставщика в каталоге;
• на балансе организации есть средства.

Полная настройка первого запроса разобрана в быстром старте AI Gateway. Если проверка всё равно завершается ошибкой, обратитесь в поддержку и сообщите время запроса, путь, model ID и код ошибки — без полного API-ключа.