> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Open WebUI

> Как подключить self-hosted Open WebUI к RuAPI: OpenAI API Base URL или переменные окружения

[Open WebUI](https://openwebui.com) — self-hosted веб-интерфейс для чата с моделями. Помимо Ollama он умеет работать с любым **OpenAI-совместимым** API, поэтому RuAPI подключается как OpenAI-соединение — достаточно адреса и ключа.

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

<Steps>
  <Step title="Аккаунт RuAPI и API-ключ">
    Консоль → **Токены** → создайте ключ `sk-...`. Баланс пополняется в USDT — см. [Пополнение](/ru/topup).
  </Step>

  <Step title="Запущенный Open WebUI">
    Установка по [инструкции Open WebUI](https://docs.openwebui.com) (обычно Docker).
  </Step>
</Steps>

## Способ 1: через интерфейс

<Steps>
  <Step title="Откройте настройки соединений">
    **Admin Panel → Settings → Connections** (или Settings → Connections для текущего пользователя).
  </Step>

  <Step title="Добавьте OpenAI-соединение">
    Включите OpenAI API и впишите:

    | Поле             | Значение                                 |
    | ---------------- | ---------------------------------------- |
    | **API Base URL** | `https://www.ruapi.ai/v1`  — **с** `/v1` |
    | **API Key**      | `sk-ваш-ключ`                            |

    Сохраните. Open WebUI подтянет список моделей через `/v1/models`.
  </Step>
</Steps>

## Способ 2: через переменные окружения

При запуске контейнера задайте:

```bash theme={null}
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://www.ruapi.ai/v1 \
  -e OPENAI_API_KEY=sk-ВАШ_КЛЮЧ \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main
```

## Проверка

Создайте новый чат, выберите модель (например `claude-opus-4-8`) и отправьте сообщение. Ответ + запись в Консоли RuAPI → **Логи** = всё работает.

## Решение проблем

<AccordionGroup>
  <Accordion title="Список моделей пустой">
    * Проверьте, что Base URL — `https://www.ruapi.ai/v1` с `/v1`: модели тянутся через `/v1/models`.
    * Ключ должен быть токеном RuAPI (`sk-...`).
  </Accordion>

  <Accordion title="401 / ошибка авторизации">
    Ключ неверный или с пробелами. Сверьте состояние в Консоли RuAPI → **Токены**.
  </Accordion>

  <Accordion title="Хочу оставить и Ollama, и RuAPI">
    Можно: Open WebUI поддерживает несколько соединений одновременно. Локальные модели Ollama и облачные модели RuAPI будут в одном списке выбора.
  </Accordion>
</AccordionGroup>