Когда нужен собственный AI-провайдер
В настройках Deskgram можно добавить отдельный AI-сервис с совместимым API и затем выбрать его модель в поддерживающем AI модуле. Для подключения нужны адрес API, ключ и точные идентификаторы моделей. Название сервиса в форме — ваша подпись в интерфейсе, а не подтверждение совместимости.
Поддерживается конкретная схема запросов: список моделей через /models и генерация через /chat/completions. Поставщик может использовать другой формат авторизации, другой ответ или требовать дополнительные параметры. Поэтому нельзя заранее считать совместимым любой сервис с пометкой «OpenAI-compatible».

Снимки показывают русскую версию интерфейса. Новые поля, в том числе несколько моделей и выбор модели по умолчанию, описаны ниже, даже если их нет на старом снимке.
Подготовьте доступ
В кабинете провайдера найдите документацию API, создайте ключ с нужными правами и проверьте условия оплаты, доступные модели и лимиты. Подписка на чат в браузере не обязательно включает API.
Для примера адрес https://provider.example/v1 означает корень API, а не рабочий сервис. Не вставляйте в Base URL полный адрес /chat/completions: Deskgram сам добавляет путь операции. Если поставщик документирует другой корень, используйте его, включая нужную версию API.
Не отправляйте ключ в сообщения поддержки или на скриншоты. Если ключ раскрыт, отзовите его в кабинете провайдера и замените в настройках.
Добавить провайдера и модели
- Откройте настройки → API → собственные провайдеры и форму добавления.
- Укажите понятное имя, например название сервиса и назначение.
- Введите Base URL и API Key из кабинета поставщика.
- Добавьте хотя бы одну модель: в поле ID нужен точный технический идентификатор, а в поле названия можно указать удобную подпись. Подпись не заменяет ID в запросе.
- При нескольких моделях отметьте звёздочкой модель по умолчанию. Первая добавленная модель первоначально выбирается основной; проверьте выбор перед сохранением.
- Настройку поддержки баланса включайте только для провайдера, для которого такая проверка действительно поддерживается. Этот флажок не создаёт универсальный способ получения баланса любого сервиса.


Что проверяет кнопка Test
Тест сначала пытается получить список моделей. Найденные модели можно добавить по одной или все сразу, затем проверить их ID и основную модель. Успешный ответ списка ещё не подтверждает право генерации выбранной моделью.
Если список недоступен, но модель по умолчанию указана вручную, проверка может выполнить короткий запрос генерации. Такой запрос расходует квоту и может тарифицироваться провайдером. Если список получить не удалось и ID модели неизвестен, найдите его в документации сервиса, добавьте вручную и повторите тест.

После успешной проверки сохраните форму. Для сохранения нужны имя, URL, ключ и хотя бы одна модель с ID. Затем выберите этого провайдера и модель в нужном AI-модуле. Перед обычным запуском отдельно проверьте короткую генерацию: язык, формат ответа, отсутствие текста ошибки. Если у выбранного модуля есть предпросмотр, используйте его. Иначе сначала проверьте модель в API-консоли поставщика и затем выполните небольшой запуск модуля на своих тестовых данных. Это отдельная проверка от получения списка моделей; не отправляйте пробный результат посторонним получателям.
Ошибки, стоимость и запасные модели
Если соединение не работает, проверьте Base URL и путь версии API, ключ, права на модель, точный ID, доступную квоту и ответ в журнале. Замена красивого названия модели не исправляет неверный ID. Повторные запросы при исчерпанной квоте не заменяют пополнение или изменение лимита в кабинете.
Несколько моделей в карточке позволяют выбирать их в интерфейсе. Это не обещание автоматического перехода на любую другую модель или другого собственного провайдера при ошибке. У встроенных провайдеров есть отдельная логика fallback; её нельзя переносить на все кастомные подключения.
Стоимость, бесплатные квоты и ограничения определяет поставщик API. Нулевое или отсутствующее отображение цены в интерфейсе не означает бесплатную генерацию. Это относится и к Mistral: доступ, оплата и лимиты проверяются в его действующих условиях, а успешный тест не гарантирует безошибочные ответы в дальнейшем.
Снимки интерфейса
Снимок показывает пример выбора провайдера в русской версии AI-модуля; расположение элементов может отличаться.
