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

# Polza.ai

> Использование шлюза Polza.ai с Yahont

## Руководство

Настройте Yahont на использование моделей, доступных через шлюз [Polza.ai](https://polza.ai/).
Polza.ai работает по протоколу OpenAI Chat Completions.

В Yahont CE вы используете собственный ключ (BYOK). Кошелька платформы нет. Как получить ключ,
цены и список моделей — смотрите на [сайте Polza.ai](https://polza.ai/).

**1. Получите API-ключ**

Войдите в аккаунт на [сайте Polza.ai](https://polza.ai/) и создайте API-ключ.

**2. Откройте «Языковые модели»**

Откройте **Панель администратора → Языковые модели**.
В группе **Шлюзы и роутеры** найдите карточку **Polza.ai** и нажмите **Подключить**.

**3. Заполните настройки**

* **API Base URL** (обязательно): адрес API шлюза вместе с версией. По умолчанию подставлен
  `https://polza.ai/api/v1`. Адрес можно изменить.
* **API-ключ** (обязательно): ключ, который вы получили в Polza.ai.
* **Отображаемое имя** (необязательно): так Yahont называет поставщика в приложении.

**4. Загрузите список моделей**

В блоке **Модели** нажмите кнопку обновления рядом с кнопкой **Выбрать все**.
Yahont запросит у шлюза список моделей и покажет его. Выберите модели, которые должны быть видны пользователям,
и при необходимости нажмите **Сделать по умолчанию**. Модель, которой нет в списке,
можно добавить вручную кнопкой **Добавить модель**.

**5. Сохраните поставщика**

Нажмите **Подключить**.

## Какие модели показывает Yahont

Yahont запрашивает список у шлюза (`/models`) и показывает только текстовые модели. Модели для изображений, видео,
звука и эмбеддингов в список не попадают.

* Идентификатор модели имеет вид `vendor/model`, например `anthropic/claude-sonnet-4.5`.
* Длину контекста, поддержку изображений на входе и поддержку рассуждений Yahont берёт из каталога шлюза.

## Голос и изображения

Шлюз Polza.ai подходит и для других функций Yahont. Они настраиваются отдельно и используют ваш ключ:

* **Голос** (распознавание и озвучивание): запросы идут на `/audio/transcriptions` и `/audio/speech`.
  Режима Realtime у шлюза нет. Подробнее — на странице [Голосовой режим](/admins/actions/voice_mode).
* **Генерация изображений**: подробнее — на странице [Генерация изображений](/admins/actions/image_generation).

## Устранение неполадок

> **Список моделей не загружается**
>
> Проверьте адрес в поле **API Base URL** и API-ключ. Адрес должен включать версию API (`/api/v1`).
> Причину ошибки смотрите в логах. Выполните из каталога `deployment/docker_compose`:
>
> ```bash theme={null}
> docker compose logs api_server
> ```

> **Дорогая модель отвечает ошибкой, а дешёвая работает**
>
> Polza.ai резервирует деньги под запрос по размеру `max_tokens`.
> На дорогих моделях при малом остатке шлюз отвечает ошибкой вида «Резервация под запрос (N ₽)
> превышает доступный остаток лимита (M ₽)». Дешёвые модели при этом работают.
> В интерфейсе Yahont вместо неё может появиться общая ошибка соединения. Причину смотрите в логах.
> Выполните из каталога `deployment/docker_compose`:
>
> ```bash theme={null}
> docker compose logs api_server
> ```
>
> Пополните баланс в Polza.ai.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.