Провайдеры в SenDev: AI Core

Страница «Провайдеры» используется для настройки подключений к AI-сервисам. Здесь хранятся адрес сервиса, способ авторизации, доступные модели, модель по умолчанию, параметры соединения, сведения для отображения баланса и настройки журнала.

В AI Core провайдер — это не просто название внешнего сервиса, а отдельный профиль подключения. Для одного сервиса можно создать несколько профилей, например рабочий и тестовый, профили для разных ключей или профили с разными наборами моделей.

[Скриншот 1: список текстовых и графических провайдеров]

Текстовые и графические профили

Страница разделяет подключения по назначению:

Текстовые провайдеры — используются для генерации и обработки текста.
Графические провайдеры — используются для генерации изображений.

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

Стандартные профили

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

Для текста в стандартной поставке предусмотрены профили для Dummy и распространённых OpenAI-совместимых сервисов, в том числе OpenRouter, DeepSeek, Qwen/DashScope, Mistral, Groq, Together, Cerebras и Hugging Face Router. Также поддерживается Bothub.

Для изображений предусмотрены профили Dummy Image, OpenAI Images, Google Gemini Image, Qwen Image, Black Forest Labs/FLUX и универсальный вариант для REST API.

Набор готовых шаблонов не ограничивает модуль только этими сервисами. Если API совместим с одним из поддерживаемых драйверов, можно создать собственный профиль.

Восстановление недостающих стандартных профилей

На странице есть команда «Проверить и добавить отсутствующие профили». Она полезна после обновления модуля или если стандартный профиль был удалён.

Команда добавляет только отсутствующие записи. Она не должна заменять:

сохранённый API-ключ;
признак активности;
изменённый список моделей;
другие пользовательские настройки существующего профиля.

Поэтому проверку стандартных профилей можно выполнять после обновления без необходимости заново настраивать рабочие подключения.

Библиотека шаблонов подключения

Для создания нового подключения можно открыть список доступных шаблонов и выбрать действие «Заполнить форму». В форму будут подставлены типовые значения для выбранного сервиса.

После подстановки обязательно проверьте параметры. Шаблон ускоряет настройку, но рабочий API-ключ, доступность конкретных моделей и условия аккаунта определяются у самого провайдера.

Список провайдеров

Для каждого профиля в таблице отображаются основные данные:

Провайдер — название и системный код профиля;
Подключение — назначение, драйвер и основные сведения об адресе;
Авторизация — выбранный способ передачи учётных данных;
Активность — участвует ли профиль в работе;
Статус и баланс — результат последней проверки и, если настроено, данные баланса;
Действия — редактирование, включение/выключение, проверка и запрос баланса.

Включение и выключение профиля

Выключенный профиль сохраняется со всеми настройками, но не используется для рабочих запросов. Это удобнее удаления, если подключение временно не нужно.

Используйте отключение, когда:

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

Удаление имеет смысл только тогда, когда профиль точно больше не понадобится.

Проверка подключения

Для профиля доступно действие «Проверить». Оно помогает выявить очевидные проблемы подключения. После настройки всё равно рекомендуется выполнить фактический запрос через «Песочницу», потому что только реальный сценарий подтверждает доступность выбранной модели и корректность ответа.

Если профиль показывает ошибку, в строке может отображаться дополнительная информация. В первую очередь проверьте авторизацию, адрес, активность профиля и модель.

Поля формы провайдера

[Скриншот 2: форма редактирования провайдера — основные параметры и авторизация]

Системный код

Уникальный код профиля внутри AI Core. По нему система отличает одно подключение от другого.

Для нового профиля используйте короткий понятный код без случайных изменений в дальнейшем. Если профиль уже используется другими модулями или настройками, менять код без необходимости не рекомендуется.

Название

Человекочитаемое название, которое отображается в административном интерфейсе. Лучше указывать не только сервис, но и назначение, если подключений несколько: например «OpenRouter — рабочий» или «Gemini Image — тест».

Назначение профиля

Определяет, для каких запросов предназначено подключение:

Текстовый — генерация и обработка текста;
Графический — генерация изображений.

Выбирайте назначение сразу правильно: от него зависит, какие драйверы и сценарии совместимы с профилем.

Тип

Профиль можно обозначить как прямого провайдера или агрегатор. Это помогает администратору понимать схему подключения. Агрегатор обычно предоставляет доступ сразу к моделям разных разработчиков через единый API.

Драйвер

Драйвер определяет формат запросов, который AI Core будет использовать при работе с сервисом.

Для текстовых профилей доступны:

OpenAI-compatible — для API, совместимых с распространённым форматом текстовых запросов;
Bothub — отдельное подключение Bothub;
Dummy/текст — локальный тест без внешнего AI-сервиса.

Для графических профилей доступны:

OpenAI Images;
Google Gemini Image;
Qwen Image;
Black Forest Labs / FLUX;
Generic Image REST — универсальное REST-подключение;
Dummy/изображение — локальный тестовый генератор.

Если вы используете стандартный шаблон, драйвер уже выбран. Менять его без понимания формата API обычно не требуется.

Активность

Определяет, может ли профиль участвовать в запросах. Новый реальный профиль разумно сначала сохранить выключенным, проверить остальные поля, затем включить и протестировать в «Песочнице».

Сортировка

Используется как приоритет профиля при маршрутизации. Чем меньше число, тем выше приоритет.

Если у вас один профиль нужного типа, можно оставить стандартное значение. Если подключений несколько, расположите основной сервис выше резервных.

Приоритет не отменяет совместимость: текстовый профиль не станет графическим только из-за меньшего значения сортировки.

Base URL

Базовый адрес API. Для реальных подключений рекомендуется использовать HTTPS. В стандартных шаблонах адрес уже заполнен.

Не изменяйте его на адрес веб-кабинета провайдера: AI Core требуется именно адрес программного API.

API key / token

Ключ доступа к сервису. После сохранения AI Core хранит его в защищённом виде и не показывает обратно в открытом виде.

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

Перед сохранением рабочего ключа убедитесь, что на странице «Диагностика» защищённое хранилище отмечено как настроенное.

Способы авторизации

AI Core поддерживает несколько распространённых вариантов передачи учётных данных.

Bearer token

Ключ передаётся как Bearer-токен. Это один из наиболее распространённых вариантов для AI API. Если стандартный профиль уже использует этот режим, менять его не нужно.

API key в заголовке

Ключ отправляется в отдельном HTTP-заголовке. Такой вариант, например, используется сервисами, которые ожидают специальное имя заголовка вместо Bearer.

Свой заголовок с префиксом

Используется, если сервис требует нестандартное имя заголовка или специальный префикс перед значением ключа.

Basic auth

Используется для сервисов с HTTP Basic Authentication. Выбирайте этот режим только если он предусмотрен вашим API.

Без авторизации

Подходит для локального или внутреннего API, который не требует учётных данных. Для публичных внешних AI-сервисов такой режим обычно неприменим.

Заголовок и префикс

Эти поля используются совместно с режимами, где требуется собственный HTTP-заголовок. Если вы применяете стандартный профиль, оставьте значения из шаблона.

Настройка моделей

AI Core хранит список моделей непосредственно в профиле. Благодаря этому в «Песочнице» и других интерфейсах можно выбирать понятное название модели без ручного ввода идентификатора каждый раз.

Модели текстового профиля

Каждая строка может содержать:

код модели;
отображаемое название;
цену входных токенов за 1000 токенов;
цену выходных токенов за 1000 токенов.

Цена необязательна. Если её заполнить, AI Core сможет рассчитывать ориентировочную стоимость запроса для журнала и лимитов.

Модели графического профиля

Для изображения можно указать код, название и стоимость одного изображения. Это также используется для отображения расходов.

Модель по умолчанию

Используется, если вызывающий модуль не указал конкретную модель. Если поле оставлено пустым, AI Core может использовать первую модель из списка.

Рекомендуется явно выбрать рабочую модель по умолчанию, особенно если у провайдера перечислено несколько вариантов с разной стоимостью или назначением.

Валюта

Указывается для расчёта стоимости. Используйте одну и ту же валюту в ценах модели и связанных лимитах, чтобы итоговые значения было проще сравнивать.

Таймаут

Определяет, сколько времени AI Core ожидает ответ внешнего сервиса. Слишком маленькое значение может приводить к ошибкам на тяжёлых запросах, особенно при генерации изображений. Слишком большое — заставит пользователя дольше ждать при недоступном сервисе.

Если нет особых требований, используйте разумное значение из стандартного профиля или глобальной настройки.

Контроль баланса

Профиль может хранить сведения о доступном остатке и при необходимости получать их из API провайдера.

В форме предусмотрены:

остаток денежных средств и валюта;
остаток токенов;
URL проверки баланса;
пути к нужным значениям в JSON-ответе: сумма, валюта и токены.

Эти настройки необязательны. Если ваш провайдер не имеет удобного API баланса, можно не заполнять этот блок. Он не влияет на саму возможность отправлять AI-запросы.

Логирование провайдера

Логировать вызовы

Если включено, обращения через профиль записываются в журнал AI Core. Для рабочего сайта логирование обычно полезно: по нему можно найти ошибку, увидеть выбранную модель и оценить расход.

Сохранять маскированный фрагмент запроса и ответа

Позволяет хранить в журнале ограниченный фрагмент входных и выходных данных. Перед сохранением AI Core применяет маскирование чувствительных значений в соответствии с глобальными настройками.

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

Дополнительный JSON

В форме есть поле дополнительных параметров в JSON. Оно предназначено для нестандартных возможностей конкретного API.

Обычному администратору это поле заполнять не требуется. Оставляйте его без изменений, если вы не получили точные параметры от разработчика интеграции.

Ошибка в дополнительных параметрах может изменить формат запроса и привести к отказу провайдера.

Кнопки сохранения

При редактировании используйте стандартную логику:

Сохранить — записать изменения и вернуться к списку;
Применить — записать изменения и продолжить редактирование;
Отмена — выйти без сохранения последних изменений.

Если провайдер не работает

Проверяйте по порядку:

Профиль активен.
Выбран правильный тип профиля — текстовый или графический.
Драйвер соответствует API.
Base URL указан корректно.
Ключ действителен и способ авторизации выбран правильно.
Выбранная модель существует и доступна вашему аккаунту.
Не сработал лимит AI Core.
В журнале нет более точного сообщения провайдера.

Если ошибка возникает только у конкретной модели, сначала попробуйте другую модель того же профиля. Если не работает весь профиль, проверьте авторизацию и доступность API.

Итог

Раздел «Провайдеры» определяет, куда AI Core реально отправляет запросы. Рабочий профиль должен быть активным, иметь корректную авторизацию и доступную модель. После любого существенного изменения подключения выполняйте тест в «Песочнице» и проверяйте результат в журнале.