Модели

Используйте GET /v1/models, чтобы получить живой каталог, видимый вашему аккаунту. Не выводите request IDs из маркетинговых названий провайдеров; передавайте точный id из API.

Endpoint

curl https://api.rout.my/v1/models \
  -H "Authorization: Bearer $ROUTMY_API_KEY"

Заголовок Authorization необязателен для просмотра публичного каталога. С валидным ключом ответ может показать, какие модели доступны на текущем плане.

Ответ

{
  "object": "list",
  "data": [
    {
      "id": "provider/model-id",
      "object": "model",
      "created": 1700000000,
      "owned_by": "provider",
      "token_multiplier": 1,
      "is_available": true
    }
  ]
}

Поля

Поле	Тип	Значение
id	string	Точный model ID для запросов.
object	string	Всегда model для каждого элемента.
created	number	Compatibility timestamp.
owned_by	string	Провайдер или группа модели, полученная из ID.
token_multiplier	number	Множитель квоты, применяемый к фактическим токенам.
is_available	boolean	Может ли текущий ключ использовать модель.

Model IDs

Model IDs выглядят как provider-scoped строки:

provider/model-id

Некоторые compatibility endpoints могут принимать короткие алиасы, но OpenAI-compatible endpoints должны получать точный id из /v1/models.

Доступность

Если is_available равен false, модель видна в каталоге, но закрыта для текущего аккаунта или плана. Запрос к закрытой модели вернет client error, пока аккаунт не получит доступ или запрос не использует другую доступную модель.

Семейства эндпоинтов

Каталог моделей является источником правды для названий и доступности. Тип модели определяет основной endpoint:

Тип модели	Primary endpoint
Chat / text / vision input	/v1/chat/completions
Embeddings	/v1/embeddings
Images	/v1/images/generations
Video	/v1/video/generations

Если запрос падает с model_not_found, снова получите список моделей и скопируйте ID точно.