Open WebUI

Open WebUI — это богатая функциями саморазворачиваемая AI-платформа, поддерживающая полностью автономную работу без подключения к сети. Через APIYI вы можете интегрировать различные основные large language models в Open WebUI.

Быстрое развертывание

Быстрый старт с Docker

docker run -d -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main

Развертывание с Docker Compose

version: '3.6'

services:
  open-webui:
    image: ghcr.io/open-webui/open-webui:main
    container_name: open-webui
    ports:
      - "3000:8080"
    volumes:
      - open-webui:/app/backend/data
    environment:
      - OPENAI_API_BASE_URL=https://api.apiyi.com
      - OPENAI_API_KEY=Your APIYI key
    restart: unless-stopped

volumes:
  open-webui:

Настройка APIYI

Способ 1: Настройка через переменные окружения

Задайте переменные окружения во время развертывания:

docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.apiyi.com \
  -e OPENAI_API_KEY=Your APIYI key \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main

Способ 2: Настройка через интерфейс

Откройте административный интерфейс Open WebUI
Перейдите в Настройки > Подключения
Настройте в разделе OpenAI API:
- Базовый URL API: https://api.apiyi.com/v1
- Ключ API: Введите ваш ключ APIYI
Нажмите кнопку сохранения конфигурации

Ключевые моменты настройки

В URL базы API должен быть указан суффикс /v1
Ключ API можно получить в консоли APIYI
Рекомендуется использовать метод с переменными окружения для более удобного управления и обновления

Поддерживаемые модели

Open WebUI поддерживает следующие серии моделей через APIYI:

Серия моделей	ID модели	Функции
GPT-4 Turbo	`gpt-4-turbo-2024-04-09`	Последний GPT-4, сбалансированная производительность
Claude Sonnet	`claude-sonnet-4-20250514`	Обработка длинных текстов, творческое письмо
Gemini Pro	`gemini-2.5-pro`	Мультимодальные возможности, быстрый отклик
GPT-3.5 Turbo	`gpt-3.5-turbo`	Экономичная и практичная, для повседневного общения

Модели для ключевых функций

Функция	Рекомендуемая модель	Описание
Понимание изображений	`gpt-4-vision-preview`	Анализ и понимание изображений
Генерация кода	`gpt-4-turbo`	Помощь в программировании и оптимизация кода
Рассуждение	`claude-sonnet-4-20250514-thinking`	Показывает процесс рассуждения

Основные возможности

RAG (генерация с дополненным извлечением)

Open WebUI поддерживает загрузку документов и функции базы знаний:

Загрузка документов
- Поддерживает PDF, TXT, DOCX и другие форматы
- Автоматическое хранение векторизованных данных
- Поддерживает многоязычные документы
Управление базой знаний
- Создание специализированных баз знаний
- Классификация и тегирование документов
- Интеллектуальное сопоставление при извлечении

API, совместимый с OpenAI

Open WebUI предоставляет полный API, совместимый с OpenAI:

# Chat completion
curl -X POST "http://localhost:3000/api/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer Your APIYI key" \
  -d '{
    "model": "gpt-4-turbo",
    "messages": [
      {"role": "user", "content": "Hello, world!"}
    ]
  }'

Интеграция инструментов

Поддерживаются внешние инструменты и плагины:

Поиск в вебе
Выполнение кода
Генерация изображений
Обработка документов

Расширенная настройка

Настройка нескольких моделей

Настройте несколько источников моделей в docker-compose.yml:

environment:
  - OPENAI_API_BASE_URL=https://api.apiyi.com
  - OPENAI_API_KEY=Your APIYI key
  - ENABLE_OPENAI_API=true
  - ENABLE_OLLAMA_API=false

Управление правами пользователей

environment:
  - ENABLE_SIGNUP=false
  - DEFAULT_USER_ROLE=user
  - WEBHOOK_URL=Your webhook address

Сохранение данных

volumes:
  - open-webui:/app/backend/data
  - ./uploads:/app/backend/data/uploads
  - ./vector_db:/app/backend/data/vector_db

Примеры интеграции API

Интеграция Python

import requests

# Open WebUI API endpoint
api_url = "http://localhost:3000/api/chat/completions"

# Request configuration
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer Your APIYI key"
}

data = {
    "model": "gpt-4-turbo",
    "messages": [
        {"role": "user", "content": "Explain the basic principles of quantum computing"}
    ],
    "stream": False
}

# Send request
response = requests.post(api_url, headers=headers, json=data)
result = response.json()
print(result["choices"][0]["message"]["content"])

Интеграция JavaScript

const apiUrl = 'http://localhost:3000/api/chat/completions';

const requestData = {
  model: 'gpt-4-turbo',
  messages: [
    { role: 'user', content: 'Write a simple Python function' }
  ]
};

fetch(apiUrl, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer Your APIYI key'
  },
  body: JSON.stringify(requestData)
})
.then(response => response.json())
.then(data => {
  console.log(data.choices[0].message.content);
});

Устранение неполадок

Частые проблемы

Соединение не удалось

Проверьте, правильно ли указан API Base URL: https://api.apiyi.com/v1
Убедитесь в действительности API Key
Проверьте настройки firewall

Модель недоступна

Проверьте баланс аккаунта
Убедитесь, что модель входит в область обслуживания
Проверьте статус сервиса APIYI

Загрузка не удалась

Проверьте поддержку формата файла
Убедитесь, что доступно достаточно места для хранения
Проверьте ограничения на размер файла

Отладка логов

Включите режим отладки:

docker logs -f open-webui

Просмотрите подробные логи:

environment:
  - LOG_LEVEL=DEBUG
  - WEBUI_DEBUG=true

Лучшие практики

Оптимизация производительности

Выбор модели
- Для ежедневного общения используйте GPT-3.5 Turbo
- Для сложных задач используйте GPT-4 Turbo
- Для обработки длинных текстов используйте Claude Sonnet
Стратегия кэширования
- Включите кэширование бесед
- Установите разумное время истечения кэша
- Регулярно очищайте неиспользуемый кэш
Управление ресурсами
- Контролируйте использование памяти
- Установите разумные ограничения на параллельные запросы
- Регулярно создавайте резервные копии данных пользователей

Конфигурация безопасности

environment:
  - ENABLE_ADMIN_EXPORT=false
  - ENABLE_ADMIN_CHAT_ACCESS=false
  - JWT_EXPIRES_IN=7d

Оповещения мониторинга

Интегрируйте систему мониторинга:

environment:
  - ENABLE_WEBHOOKS=true
  - WEBHOOK_URL=https://your-monitoring-url

Нужна дополнительная помощь? Ознакомьтесь с Официальная документация Open WebUI или посетите Официальный сайт APIYI.

Обзор

Разговорный ИИ

Программирование

Вклад сообщества

AI-агент

Инженерия

Перевод

Быстрое развертывание

Быстрый старт с Docker

Развертывание с Docker Compose

Настройка APIYI

Способ 1: Настройка через переменные окружения

Способ 2: Настройка через интерфейс

Поддерживаемые модели

Рекомендуемые модели

Модели для ключевых функций

Основные возможности

RAG (генерация с дополненным извлечением)

API, совместимый с OpenAI

Интеграция инструментов

Расширенная настройка

Настройка нескольких моделей

Управление правами пользователей

Сохранение данных

Примеры интеграции API

Интеграция Python

Интеграция JavaScript

Устранение неполадок

Частые проблемы

Отладка логов

Лучшие практики

Оптимизация производительности

Конфигурация безопасности

Оповещения мониторинга

​Быстрое развертывание

​Быстрый старт с Docker

​Развертывание с Docker Compose

​Настройка APIYI

​Способ 1: Настройка через переменные окружения

​Способ 2: Настройка через интерфейс

​Поддерживаемые модели

​Рекомендуемые модели

​Модели для ключевых функций

​Основные возможности

​RAG (генерация с дополненным извлечением)

​API, совместимый с OpenAI

​Интеграция инструментов

​Расширенная настройка

​Настройка нескольких моделей

​Управление правами пользователей

​Сохранение данных

​Примеры интеграции API

​Интеграция Python

​Интеграция JavaScript

​Устранение неполадок

​Частые проблемы

​Отладка логов

​Лучшие практики

​Оптимизация производительности

​Конфигурация безопасности

​Оповещения мониторинга

Быстрое развертывание

Быстрый старт с Docker

Развертывание с Docker Compose

Настройка APIYI

Способ 1: Настройка через переменные окружения

Способ 2: Настройка через интерфейс

Поддерживаемые модели

Рекомендуемые модели

Модели для ключевых функций

Основные возможности

RAG (генерация с дополненным извлечением)

API, совместимый с OpenAI

Интеграция инструментов

Расширенная настройка

Настройка нескольких моделей

Управление правами пользователей

Сохранение данных

Примеры интеграции API

Интеграция Python

Интеграция JavaScript

Устранение неполадок

Частые проблемы

Отладка логов

Лучшие практики

Оптимизация производительности

Конфигурация безопасности

Оповещения мониторинга