Skip to main content
Open WebUI (раніше Ollama WebUI) — це клієнт 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 дійсний, але баланс недостатній — поповніть його в консолі.

​
Розширене: база знань і багато користувачів

База знань (RAG) Open WebUI за замовчуванням використовує 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.

​
Дізнатися більше