Интеграция≈ 3 мин чтения

Open WebUI + NeuroAPI: подключение за несколько шагов

Два способа подключить Open WebUI к NeuroAPI: через переменные окружения Docker или через настройки соединений в админ-панели.

Короткий ответ

Краткий ответ

Подключите Open WebUI к NeuroAPI через настройки соединений или Docker-переменные: base_url https://neuroapi.host/v1, API-ключ и модели из каталога.

Два способа

Настройки соединений в админ-панели или переменные окружения OPENAI_API_BASE_URL и OPENAI_API_KEY при запуске.

Один адрес

Для OpenAI API в Open WebUI укажите https://neuroapi.host/v1 — без /chat/completions в конце.

Модели подтягиваются

Open WebUI запрашивает список моделей через GET /v1/models; доступность зависит от тарифа ключа.

Командный доступ

Для нескольких сотрудников удобнее корпоративный workspace с ролями и отдельными ключами.

Что нужно до запуска

Создайте API-ключ NeuroAPI в личном кабинете и выберите тариф. Для Open WebUI обычно используют обычный ключ тарифа Пилот или Смарт; для командного продакшена — корпоративный workspace.

Определите, как будет запускаться Open WebUI: Docker-контейнер или локальная установка. От этого зависит, где удобнее задать адрес API и ключ.

  • Ключ NeuroAPI с выбранным тарифом.
  • Docker или локальная установка Open WebUI.
  • Понимание, какие модели нужны пользователям — список берётся из /price.

Вариант 1: Docker и переменные окружения

При запуске контейнера передайте адрес API и ключ через переменные окружения. Open WebUI обратится к NeuroAPI при первом запросе списка моделей, и они появятся в интерфейсе выбора модели.

Ключ в переменных окружения — секрет. Не коммитьте docker-compose с реальным ключом в репозиторий; используйте .env-файл на сервере и ограничьте доступ к нему.

Вариант 2: настройки соединений в админ-панели

Если Open WebUI уже запущен, откройте админ-панель → Settings → Connections и добавьте OpenAI-соединение: API Base URL https://neuroapi.host/v1 и API Key NeuroAPI. Сохраните настройки и обновите список моделей.

Названия разделов могут отличаться между версиями Open WebUI. Если модели не появились, проверьте, что в адресе нет лишнего сегмента и что ключ активен.

  • Admin Panel → Settings → Connections.
  • OpenAI API: Base URL https://neuroapi.host/v1.
  • API Key: ключ NeuroAPI.
  • После сохранения обновите список моделей.

Ограничения и типовые ошибки

Open WebUI — это интерфейс, а не отдельный API. Возможности чата (стриминг, изображения, инструменты) зависят от модели и от того, как сам Open WebUI их отправляет. Если функция не работает, сначала проверьте карточку модели.

401 означает неверный ключ, 404 — неизвестный Model ID, 429 — превышение лимитов. Для корпоративного контура проверьте роли и лимиты ключей, чтобы не расходовать общий баланс бесконтрольно.

  • Список моделей — GET /v1/models.
  • Ошибки 401/404/429 разбираются так же, как в других OpenAI-совместимых клиентах.
  • Для команды используйте отдельные ключи и корпоративный workspace.

Командный доступ и расходы

Если Open WebUI используют несколько сотрудников, один общий ключ усложняет аудит: невозможно понять, кто израсходовал баланс. В корпоративном workspace роли и отдельные ключи решают это: техническая команда работает с API, финансы видят счета и документы, наблюдатели — только чтение.

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

  • Отдельные ключи вместо одного общего.
  • Роли workspace: разработчик, бухгалтерия, наблюдатель.
  • Ограничьте список моделей для командного интерфейса.
  • Мониторьте расход в кабинете.

Пример docker-compose

yaml
services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    ports:
      - "3000:8080"
    environment:
      OPENAI_API_BASE_URL: "https://neuroapi.host/v1"
      OPENAI_API_KEY: "<NEUROAPI_API_KEY>"
    volumes:
      - open-webui:/app/backend/data

volumes:
  open-webui: