GET /v1/models

Возвращает минимальный список OpenAI-формата с включёнными каноническими моделями, доступными аутентифицированному ключу. Каждая запись содержит ровно id, object, created и owned_by. Это чтение не выполняет генерацию.

Аутентификация и запрос

curl 'https://api.model-gate.com/v1/models' \
  -H "Authorization: Bearer $MODEL_API_KEY"

Также принимается x-api-key. Активные и замороженные ключи могут читать каталог моделей; замороженный ключ по-прежнему не может выполнять inference. Действуют существующие ограничения домена, IP и компании.

Ответ

{
  "object": "list",
  "data": [
    {
      "id": "minimax-m3",
      "object": "model",
      "created": 1784882385,
      "owned_by": "model-gate"
    }
  ]
}

Это пример структуры, не обещание доступности данной модели вашему аккаунту. created — сохранённая Unix-отметка в секундах; owned_by — настроенный владелец. Пустой доступный каталог возвращает {"object":"list","data":[]}, а не null.

Совместимость начиная с 12.0.0

Прежний расширенный ответ временно отключён. Цены, алиасы, описания, признаки возможностей и лимиты контекста/токенов не возвращаются. Параметры вроде ?view=extended и ?view=details их не включают. До установки этого основного выпуска обновите интеграции, которым нужны эти поля, и обновите закэшированные метаданные моделей.

Откройте Модели и цены в аккаунте для известных токенных лимитов, тарифов аккаунта и отдельных списков Images, Audio и Video. Медиа-карточки показывают проверенные параметры и ограничения контрактов маршрутов. Для текущих прав и цены конкретного запроса используйте соответствующий медиа-каталог и расчёт цены с нужным ключом в Playground; одного ID модели недостаточно для медиа-предложения. Настройки Usage Limit ключа/группы отделены от карточек уровня аккаунта.

Включённые алиасы продолжают разрешаться при запросах и поиске одной модели, но не перечисляются в минимальном ответе. Получите поддержанный алиас из документации или у администратора аккаунта; не придумывайте его.

Ошибки и права компании

Отсутствующая или неверная авторизация возвращает обычную структурированную ошибку аутентификации. Новые запросы к запрещённой политикой компании модели возвращают company_model_not_allowed; смена протокола не обходит политику. Для существующих собственных результатов сохраняются первоначальные права и сроки хранения. Видимость каталога может кратко отставать от изменения разрешений; выполнение независимо проверяет текущий доступ.

Ключи со статусом active или frozen могут читать каталог моделей; замороженный ключ по-прежнему заблокирован на inference-эндпоинтах.