Перейти к основному содержимому

Подключение нейросети

Чтобы модуль мог генерировать контент, к нему нужно подключить нейросеть (LLM). Без активного провайдера генерация недоступна. На этой странице — какие провайдеры поддерживаются, где взять API-ключ, как устроен каталог моделей и как проверить связь.

Модуль не продаёт токены

Модуль не берёт отдельную плату за генерацию. Оплата за токены идёт напрямую вашему провайдеру нейросети по его тарифам — модуль работает вашим ключом и вашим балансом. Подключение прямое: модуль обращается к API провайдера, промежуточных серверов нет, данные не передаются третьим сторонам.

Поддерживаемые провайдеры​

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

Polza.ai — оплата в рублях​

Российский агрегатор нейросетей с оплатой в рублях — без зарубежной карты и без VPN. Через него доступны модели GPT, Claude, Gemini, DeepSeek и другие. Веб-поиск работает на всех моделях.

Оптимальный выбор для большинства проектов на 1С-Битрикс: бухгалтерия принимает документы, доступ не требует обходных путей.

OpenRouter — самый большой каталог моделей​

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

Доступность в России

На данный момент OpenRouter заблокирован для пользователей из РФ со стороны самого OpenRouter. Если вы работаете из России, используйте Polza.ai или собственный шлюз.

Свой OpenAI-совместимый эндпоинт​

Любой собственный или корпоративный шлюз, локальная модель или иной провайдер с OpenAI-совместимым API. Идентификатор модели вводится вручную, дополнительно указывается URL эндпоинта.

Этот вариант выбирают, когда данные нельзя выпускать за периметр: запросы уходят на ваш сервер, а не во внешний сервис.

Где взять API-ключ​

Для каждого провайдера ключ берётся в личном кабинете соответствующего сервиса:

  • Polza.ai — зарегистрируйтесь, пополните баланс в рублях и создайте API-ключ в личном кабинете.
  • OpenRouter — зарегистрируйтесь, пополните баланс в USD и создайте ключ в разделе ключей.
  • Свой эндпоинт — ключ и URL предоставляет администратор вашего шлюза.
подсказка

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

Шаги настройки​

  1. Откройте «Настройки → Основное».
  2. Выберите провайдера из списка.
  3. Вставьте полученный API-ключ (для своего эндпоинта — также URL).
  4. Сохраните настройки и выберите модель по умолчанию.
  5. Проверьте связь — см. ниже.
к сведению

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

Каталог моделей и цены​

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

Модель задаётся на двух уровнях:

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

Типичный расклад: описание товара пишет модель посильнее, мета-теги по готовому описанию — модель подешевле.

Проверка ключа и мини-чат​

Рядом с настройками провайдера есть мини-чат — отправьте в него любое сообщение и убедитесь, что ключ принят, модель отвечает и с сервера есть доступ к API провайдера. Это самый быстрый способ отделить проблему подключения от проблемы промпта.

Что проверяет мини-чат:

  • ключ действителен и не исчерпал лимит;
  • выбранная модель доступна на вашем тарифе;
  • с сервера сайта есть исходящий доступ к API провайдера (без него генерация не заработает — см. Требования).

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

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

Фактический расход по каждому шагу и прогону виден в хронологии на дашборде.

Дальше переходите к настройке источника данных и конвейера.