> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kvantora.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Единый каталог моделей

> Операции, параметры, RUB-тарифы и доступность.

`GET /v1/models` возвращает ту же модель, которую используют публичный каталог, Studio и MCP. Копируйте `public_api_id` в поле `model`; `id` в `/v1/models` содержит то же значение. `api_aliases` перечисляет опубликованные альтернативные ID. Сервер разрешает их в `canonical_id`, который сохраняет единую идентичность модели. Не собирайте ID из названия карточки.

## Найдите модель

Для фильтрации доступны `q`, `operation`, `enabled`; страницы задаются `page` и `page_size` от 1 до 100. Ответ содержит `pagination`. Фильтрация выполняется до пагинации. Поиск `q` проверяет ID модели, опубликованные aliases, slug, название и разработчика без учёта регистра. Описания моделей в поиске не участвуют.

```bash theme={null}
curl --get "$KVANTORA_BASE_URL/v1/models" \
  -H "Authorization: Bearer $KVANTORA_API_KEY" \
  --data-urlencode "operation=chat" \
  --data-urlencode "enabled=true" \
  --data-urlencode "page=1" \
  --data-urlencode "page_size=20"
```

Для поиска добавьте `q` с ID, названием или разработчиком. Пустой результат после фильтра `enabled=true` означает, что по этим условиям нет доступной операции; не подставляйте имя похожей модели наугад.

## Проверьте операцию

Проверяйте `availability.operations` для нужной операции. Поле `enabled` разрешает запуск, `api_path` задаёт endpoint, `studio_supported` сообщает о наличии интерфейса Studio. Embeddings доступны через API; отдельная форма Studio для них не предусмотрена.

Проверяйте доступность непосредственно перед отправкой. Если нужная операция отключена, выберите другую доступную модель или вернитесь к запросу позже. Не заменяйте модель после отправки запроса с неизвестным исходом: сначала проверьте первоначальный результат.

## Сравните цены

Каждая цена содержит `amount_microrub`, `currency: RUB`, `unit`, `quantity`, `operation`, `condition`. Например, unit=token и quantity=1000000 означают цену за миллион токенов. Ноль означает опубликованную нулевую цену; отсутствие цены не означает бесплатный запрос.

Сравнивайте одинаковые операции и единицы: цена входных токенов не заменяет цену выходных, а цена за запрос не равна цене за миллион токенов. Для вывода суммы в рублях используйте [точное форматирование](/billing). Для медиа оцените конкретный запрос до запуска.

## Даты

`dates.release` и `dates.supplier_added` могут быть `null`: неизвестная дата не заменяется временем импорта. У известной даты есть `value`, `precision` (`month`, `day` или `timestamp`) и `provenance`. `supplier_declared_release` означает заявленную дату выпуска; `supplier_added` — дату добавления в каталог источника. Не показывайте месяц как точный день выпуска.