Предварительные требования
1
Аккаунт RuAPI и API-ключ
Консоль → API-ключи → создайте ключ
sk-.... Баланс пополняется в USDT — см. Пополнение.2
Запущенный Open WebUI
Установка по инструкции Open WebUI (обычно Docker).
Способ 1: через интерфейс
1
Откройте настройки соединений
Admin Panel → Settings → Connections (или Settings → Connections для текущего пользователя).
2
Добавьте OpenAI-соединение
Включите OpenAI API и впишите:
Сохраните. Open WebUI подтянет список моделей через
/v1/models.Способ 2: через переменные окружения
При запуске контейнера задайте:Проверка
Создайте новый чат, выберите модель (напримерclaude-opus-5-5) и отправьте сообщение. Ответ + запись в Консоли RuAPI → Журнал запросов = всё работает.
База знаний (RAG)
Чтобы Open WebUI считал эмбеддинги документов через RuAPI: Панель администратора (Admin Panel) → Настройки (Settings) → Документы (Documents) → Движок модели встраивания (Embedding Model Engine) — выберите OpenAI, укажите адресhttps://www.ruapi.ai/v1, ваш ключ RuAPI и модель text-embedding-3-small (или text-embedding-3-large), сохраните. То же через переменные окружения: RAG_EMBEDDING_ENGINE=openai, RAG_OPENAI_API_BASE_URL=https://www.ruapi.ai/v1, RAG_OPENAI_API_KEY=sk-ВАШ_КЛЮЧ, RAG_EMBEDDING_MODEL=text-embedding-3-small (адрес и ключ можно не указывать — тогда берутся OPENAI_API_BASE_URL и OPENAI_API_KEY). Переменные действуют только при первом запуске, дальше настройки меняйте в панели администратора. После смены модели эмбеддингов загруженные ранее документы нужно переиндексировать (там же, строка «Переиндексировать векторы знаний и памяти» — кнопка «Переиндексировать»). Модели эмбеддингов открываются после пополнения баланса.
Решение проблем
Список моделей пустой
Список моделей пустой
- Проверьте, что Base URL —
https://www.ruapi.ai/v1с/v1: модели тянутся через/v1/models. - Нужен ключ RuAPI (
sk-...).
401 / ошибка авторизации
401 / ошибка авторизации
Ключ неверный или с пробелами. Сверьте состояние в Консоли RuAPI → API-ключи.
Хочу оставить и Ollama, и RuAPI
Хочу оставить и Ollama, и RuAPI
Можно: Open WebUI поддерживает несколько соединений одновременно. Локальные модели Ollama и облачные модели RuAPI будут в одном списке выбора.