Skip to main content
Open WebUI (ранее Ollama WebUI) — это open-source AI-клиент, поддерживающий многопользовательский режим, базу знаний, RAG и частное развертывание. Он поддерживает пользовательские совместимые с OpenAI конечные точки, поэтому может подключаться к Ace Data Cloud. В этой статье описывается процесс настройки.

​
Процесс получения

Чтобы подключить Ace Data Cloud в Open WebUI, сначала перейдите в консоль Ace Data Cloud, получите ваш API Token и сохраните его для дальнейшего использования. Получение Ace Data Cloud API Key Если вы еще не вошли в систему или не зарегистрировались, вы будете автоматически перенаправлены на страницу входа с приглашением зарегистрироваться и войти, после входа и регистрации вы автоматически вернетесь на текущую страницу. При первом получении предоставляется бесплатная квота, с которой можно бесплатно попробовать модельные сервисы Ace Data Cloud.

​
Развертывание и настройка Ace Data Cloud

Open WebUI подключается к совместимым с OpenAI конечным точкам через переменные окружения, развертывание выполняется одной командой Docker (замените {token} на ваш Token):
Откройте http://IP_вашего_сервера:3000, первая зарегистрированная учетная запись автоматически становится администратором. Обратите внимание на правила пути Base URL: После входа перейдите в Admin Panel → Settings → Connections и нажмите «Verify Connection» для проверки; в Settings → Models можно отфильтровать и Pin часто используемые модели.
Помимо использования переменных окружения, Open WebUI также поддерживает добавление подключения напрямую в интерфейсе: перейдите в Admin Settings → Connections, нажмите ➕ и заполните URL (https://api.acedata.cloud/v1) и API Key, после чего Open WebUI автоматически вызовет /models для получения списка моделей. Подробнее см. в официальной документации Starting With OpenAI-Compatible Servers.
Интерфейс настройки подключения Open WebUI Ace Data Cloud
MODEL_ID используется только для демонстрации необязательного allow list; если оставить пустым, будут отображены все модели, возвращаемые /models.

​
Выбор модели

Каталог моделей будет постоянно обновляться. В приоритете используйте автоматически загружаемый клиентом список моделей; если необходимо заполнить вручную, сначала запросите GET https://api.acedata.cloud/v1/models, чтобы получить текущие ID моделей, затем выберите в соответствии с поддерживаемыми клиентом возможностями контекста, изображений и вызова инструментов.

​
Проверка интеграции

Если вы не уверены, связана ли проблема с Open WebUI или сетью, можно сначала напрямую проверить конечную точку с помощью curl (замените {token} на ваш Token):
Возврат совместимого с OpenAI объекта chat.completion означает, что Token и конечная точка готовы; если возвращается HTTP 403 used_up, это означает, что Token действителен, но баланса недостаточно — пополните счет в консоли.

​
Расширенно: база знаний и многопользовательский режим

База знаний Open WebUI (RAG) по умолчанию использует ChromaDB для хранения векторов, в качестве модели эмбеддингов можно указать text-embedding-3-large (через Ace Data Cloud), исходные тексты документов хранятся только на вашем сервере, модели будут отправлены только найденные фрагменты. В Admin Panel → Users можно управлять ролями пользователей (Pending / User / Admin); рекомендуется установить «Default User Role» в pending, чтобы новые пользователи могли использовать систему только после проверки, избегая произвольной регистрации посторонних лиц и расходования квоты. Если используется обратное проксирование nginx, добавьте proxy_buffering off; и client_max_body_size 100M;.

​
Часто задаваемые вопросы

​
Появляется Connection error / 404

Обычно OPENAI_API_BASE_URL указан как .../openai/v1 или отсутствует /v1. Измените на https://api.acedata.cloud/v1.

​
Невозможно начать диалог после загрузки документа

В настройках RAG панели Admin Panel выберите модель эмбеддингов text-embedding-3-large (OpenAI provider).

​
Данные теряются после перезапуска контейнера

При запуске необходимо подключить том данных -v open-webui:/app/backend/data.

​
Узнать больше