К содержимому

Open WebUI API: подключение и настройка моделей

Open WebUI подключается к шлюзу как OpenAI-совместимый провайдер: адрес с /v1 в переменной OPENAI_API_BASE_URL или в разделе Connections админки.

  • Тип: Чат и настольное приложение
  • Протокол: OpenAI Chat Completions
  • Статус: Работает
Настройки сверены с официальной документацией клиента, 2026-10-02. Не проверено вручную: запуск клиента против шлюза не выполнялся.

Что заработает

ВозможностьОтметкаПримечание
ЧатДа
Потоковый ответДа
ЭмбеддингиНетУ шлюза нет /v1/embeddings: RAG работает только со встроенными эмбеддингами.

Настройка

Понадобятся ключ из раздела «Ключи» кабинета и идентификатор модели. В примерах подставлена модель gpt-5.6-luna; для протокола Anthropic Messages подставлена claude-haiku-5-5. Свою модель выбирайте в каталоге.

Клиенту нужен ключ. Задайте его в переменной окружения RELAY_API_KEY: примеры ниже читают ключ оттуда. Чтобы переменная сохранялась между сеансами, добавьте строку export в ~/.zshrc (bash: ~/.bashrc, bash на macOS: ~/.bash_profile), в PowerShell вызовите [Environment]::SetEnvironmentVariable с областью User, в cmd выполните setx и откройте новое окно. Окно, открытое до setx, переменную не увидит.

Ключ в переменной окружения

macOS и Linux

bash
read -rs RELAY_API_KEY && export RELAY_API_KEY

Windows PowerShell

bash
$env:RELAY_API_KEY = "YOUR_API_KEY"

Windows cmd

bash
set "RELAY_API_KEY=YOUR_API_KEY"
  1. Запустите Open WebUI в Docker с переменными из примера или добавьте подключение в админке.
  2. В админке откройте Settings, Admin Settings, Connections, Manage OpenAI API Connections, Add Connection.
  3. Введите адрес https://relay-llm.ru/v1, ключ и список идентификаторов моделей, например gpt-5.6-luna.
  4. Выберите модель в чате.

Запуск в Docker

macOS и Linux

bash
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL="https://relay-llm.ru/v1" \
  -e OPENAI_API_KEY="$RELAY_API_KEY" \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Windows PowerShell

bash
docker run -d -p 3000:8080 `
  -e OPENAI_API_BASE_URL="https://relay-llm.ru/v1" `
  -e OPENAI_API_KEY="$env:RELAY_API_KEY" `
  -v open-webui:/app/backend/data `
  --name open-webui `
  ghcr.io/open-webui/open-webui:main

Windows cmd

bash
docker run -d -p 3000:8080 ^
  -e OPENAI_API_BASE_URL="https://relay-llm.ru/v1" ^
  -e OPENAI_API_KEY="%RELAY_API_KEY%" ^
  -v open-webui:/app/backend/data ^
  --name open-webui ^
  ghcr.io/open-webui/open-webui:main

Поля подключения в админке

text
URL: https://relay-llm.ru/v1
API Key: YOUR_API_KEY
Model IDs: gpt-5.6-luna

Проверка

Сначала проверьте ключ и адрес без клиента. В ответе должно быть is_active: true.

macOS и Linux

bash
curl https://relay-llm.ru/v1/key \
  -H "Authorization: Bearer $RELAY_API_KEY"

Windows PowerShell

bash
curl.exe https://relay-llm.ru/v1/key `
  -H "Authorization: Bearer $env:RELAY_API_KEY"

Windows cmd

bash
curl https://relay-llm.ru/v1/key ^
  -H "Authorization: Bearer %RELAY_API_KEY%"

Затем проверьте сам клиент.

Откройте чат, выберите модель и отправьте «ping». Ответ пришёл, запись видна в журнале запросов кабинета.

Запрос из клиента появится в журнале запросов кабинета с моделью, токенами и стоимостью.

Ограничения протоколов

OpenAI Chat Completions

Работают чат-модели каталога по пути /v1/chat/completions. Не поддерживаются /v1/embeddings, /v1/audio/*, /v1/moderations, /v1/batches, Assistants и Realtime: функции клиента, которым они нужны, не заработают.

Ловушки

  • Переменные окружения применяются только при первом запуске (PersistentConfig). Потом приоритет у значений из базы и админки. Если поменяли переменную, а поведение прежнее, правьте значение в админке.
  • Список моделей берётся из /v1/models. Если список пуст, добавьте идентификаторы в список вручную: чат при этом работает.
  • В Docker вместо localhost для сервисов на хосте нужен host.docker.internal. Адрес шлюза публичный, для него это не нужно.
  • Эмбеддинги для RAG не заработают: у шлюза нет /v1/embeddings. Выберите встроенную модель эмбеддингов Open WebUI.
  • Клиентом Anthropic Messages Open WebUI к шлюзу не станет: нативный режим Anthropic в документации не подтверждён.

Официальная документация: Open WebUI API: подключение и настройка моделей

Подключение клиентов: общие сведения и все клиенты

Обработка ошибок и повторы

Модели и ключ: список моделей в API

Ключи в кабинете

Готовы? Три шага, чтобы начатьВойдите в консоль · пополните баланс · создайте API Key