# Каталог моделей через API

Source: https://provod.ai/ru/docs/catalog

*Каталог моделей через API*

Используйте актуальный каталог вместо списка моделей, сохранённого в коде. Точный `id` нужен для запросов генерации; читаемое имя его не заменяет.

## Найдите подходящие модели

```bash
export API_BASE="https://api.provod.ai"
export AI_API_KEY="sk_..."

curl --fail-with-body --silent --show-error \
  "$API_BASE/v1/models?output_modalities=text&supported_parameters=max_tokens&limit=20&offset=0" \
  -H "Authorization: Bearer $AI_API_KEY"
```

`API_BASE` — адрес API без `/v1`. Ответ содержит массив `data`. Проверяйте доступность и поддержанные форматы запроса у выбранной записи; запись в каталоге не гарантирует доступную мощность в момент вызова.

| Параметр                                | Назначение                                                                    |
| --------------------------------------- | ----------------------------------------------------------------------------- |
| `q`                                     | Поиск                                                                         |
| `context`                               | Контекст                                                                      |
| `input_modalities`, `output_modalities` | Входные и выходные модальности                                                |
| `model_authors`                         | Авторы моделей                                                                |
| `supported_parameters`                  | Поддержанные параметры                                                        |
| `sort`                                  | `newest`, `context-high-to-low`, `pricing-high-to-low`, `pricing-low-to-high` |
| `limit`, `offset`                       | Размер страницы 1–1000 и смещение                                             |

`GET /v1/models/count` возвращает количество моделей для параметров фильтрации. `GET /v1/model/{author}/{slug}` возвращает карточку модели, `GET /v1/models/{author}/{slug}/endpoints` — описание её точек доступа. Кодируйте значения параметров URL, а не собирайте строку из пользовательского текста вручную.

[Выбор модели](/ru/docs/models) · [Первый запрос](/ru/docs)

## Решение проблем


**Найденная модель отклоняет запрос**


Проверьте точный ID, доступность, поддержанные форматы и параметры. Обновите каталог; не подменяйте отсутствующую модель другой без явного решения.
