Skip to main content

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

Настройте Yahont на использование моделей, доступных через шлюз Polza.ai. Polza.ai работает по протоколу OpenAI Chat Completions. В Yahont CE вы используете собственный ключ (BYOK). Кошелька платформы нет. Как получить ключ, цены и список моделей — смотрите на сайте Polza.ai.
1

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

Войдите в аккаунт на сайте 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 у шлюза нет. Подробнее — на странице Голосовой режим.
  • Генерация изображений: подробнее — на странице Генерация изображений.

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

Проверьте адрес в поле API Base URL и API-ключ. Адрес должен включать версию API (/api/v1). Причину ошибки смотрите в логах. Выполните из каталога deployment/docker_compose:
Polza.ai резервирует деньги под запрос по размеру max_tokens. На дорогих моделях при малом остатке шлюз отвечает ошибкой вида «Резервация под запрос (N ₽) превышает доступный остаток лимита (M ₽)». Дешёвые модели при этом работают. В интерфейсе Yahont вместо неё может появиться общая ошибка соединения. Причину смотрите в логах. Выполните из каталога deployment/docker_compose:
Пополните баланс в Polza.ai.