Перейти к основному содержанию
Open WebUI — self-hosted веб-интерфейс для чата с моделями. Помимо Ollama он умеет работать с любым OpenAI-совместимым API, поэтому RuAPI подключается как OpenAI-соединение — достаточно адреса и ключа.

Предварительные требования

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-...).
Ключ неверный или с пробелами. Сверьте состояние в Консоли RuAPI → API-ключи.
Можно: Open WebUI поддерживает несколько соединений одновременно. Локальные модели Ollama и облачные модели RuAPI будут в одном списке выбора.