> ## Documentation Index > Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt > Use this file to discover all available pages before exploring further. # LobeHub > Руководство по интеграции open-source клиента чата с custom providers и локальной базой знаний LobeHub — это open-source, кроссплатформенный AI chat client (ранее Lobe Chat), который поддерживает несколько моделей, мультимодальный ввод, маркетплейс плагинов и локальную базу знаний. С APIYI вы можете использовать один API key в LobeHub для доступа к 400+ основным AI моделям — не нужно регистрироваться и оплачивать каждого провайдера отдельно. Desktop, web, Docker или Vercel — ваши данные, ваш контроль Встроенные веб-поиск, code interpreter, vision и плагины для генерации видео Загружайте PDF и Markdown, чтобы построить RAG pipeline на основе ваших приватных данных ## Быстрый старт ### 1. Получите свой API-ключ APIYI См. [Руководство по управлению API Key](/ru/faq/token-management), чтобы получить свой API-ключ. ### 2. Установите LobeHub LobeHub предлагает три способа использования: * **Настольный клиент**: официальный клиент для Windows, macOS и Linux — загрузите с `lobechat.com` * **Веб (официально)**: просто перейдите на `lobechat.com`, зарегистрируйтесь и используйте без самостоятельного хостинга * **Самостоятельное развертывание**: разверните через Docker / Vercel / локальный исходный код — отлично подходит для корпоративных сценариев или требований к конфиденциальности Для личного использования мы рекомендуем официальный веб-клиент или настольный клиент. Если у вас есть требования к конфиденциальности данных или соответствию требованиям, разверните самостоятельно с Docker (просто настройте APIYI через переменные окружения). ### 3. Создайте пользовательского провайдера LobeHub — Создать пользовательского провайдера AI-сервиса Перейдите на `Settings → Model Providers`, нажмите значок `+` в правом верхнем углу, чтобы добавить пользовательского провайдера, и заполните поля, как показано выше: | Поле | Значение | Примечания | | ---------------------------- | -------------------------- | --------------------------------------------------------- | | **Идентификатор провайдера** | `apiyi` | Уникальный идентификатор — после создания изменить нельзя | | **Имя провайдера** | `apiyi` | Пользовательское отображаемое имя | | **Описание провайдера** | `apiyi` | Пользовательское описание | | **Логотип провайдера** | (оставьте пустым) | Необязательно — URL пользовательского логотипа | | **Формат запроса** | `OpenAI` | APIYI полностью совместим с OpenAI | | **URL прокси** | `https://api.apiyi.com/v1` | Базовый URL — **должен заканчиваться на `/v1`** | | **API-ключ** | Ваш API-ключ APIYI | Получите его в консоли APIYI | Нажмите кнопку **Создать** в правом нижнем углу, чтобы сохранить. **Советы по настройке** * `Proxy URL` ДОЛЖЕН заканчиваться на `/v1`, иначе запросы не будут корректно маршрутизироваться * Удалите начальные и конечные пробелы из API-ключа при вставке * Выберите `OpenAI` в качестве формата запроса, чтобы получить доступ ко всем более чем 400 моделям APIYI * Один ключ работает со всеми включенными моделями — платите только за то, что используете ### 4. Проверьте подключение LobeHub — Вид настроенного провайдера После создания провайдера вы попадете на страницу с его подробностями. Здесь вы можете: 1. **Подтвердить или обновить API-ключ и URL прокси** 2. **Включить расширенные параметры** (необязательно): * `Use Responses API spec` — включает новый формат запросов OpenAI (только для моделей OpenAI) * `Use client-side request mode` — браузер отправляет запросы напрямую, что может повысить скорость ответа 3. **Проверка подключения** — выберите модель в выпадающем списке и нажмите **Проверить** 4. **Получить список моделей** — нажмите кнопку **Получить список моделей**, чтобы загрузить все доступные модели из APIYI После успешной загрузки `Model list` показывает все, что APIYI предлагает в данный момент, сгруппированное по типам: Chat, Image, Video, Embedding, ASR, TTS. Если проверка подключения не проходит, проверьте следующее: * Заканчивается ли URL прокси на `/v1`? * Все еще ли действителен API-ключ? (проверьте в консоли APIYI) * Доступна ли ваша сеть до `api.apiyi.com`? * Не блокирует ли HTTPS-трафик брандмауэр или прокси? ### 5. Выберите модель и начните чат В выпадающем списке моделей в чате выберите модель, например `deepseek-v4-pro`, `claude-sonnet-4-5` или `gpt-5`, и можно начинать. Просматривайте последние рекомендации по моделям, сравнения производительности и советы по использованию в разных сценариях — для написания текстов, программирования, быстрого ответа, генерации изображений, генерации видео и многого другого. **Почему здесь нет конкретного списка моделей?** Модели ИИ обновляются очень быстро. Чтобы рекомендации оставались точными, мы поддерживаем актуальный список моделей, данные о производительности и советы по использованию на [странице рекомендаций по моделям](/ru/api-capabilities/model-info). ## Доступ ко всем 400+ моделям через одного провайдера LobeHub поставляется со встроенными каналами для многих основных провайдеров. Выберите канал, который подходит для вашего сценария использования: | Канал | Модели | Ключевое преимущество | API эндпоинт | | -------------------------------- | ------------------------------------------------------ | ------------------------------------------------------------- | -------------------------- | | **Совместимый с OpenAI (apiyi)** | Все 400+ моделей (Claude, Gemini, GPT, DeepSeek и др.) | Один ключ открывает доступ ко всему — самая простая настройка | `https://api.apiyi.com/v1` | **Один канал apiyi охватывает Claude, Gemini и любую другую модель** APIYI объединяет Claude, Gemini, GPT, DeepSeek и другие топовые модели под протоколом, совместимым с OpenAI. Поэтому один `apiyi` пользовательский провайдер в LobeHub дает вам доступ ко всем 400+ моделям в выпадающем списке — не нужно настраивать отдельные каналы для каждого вендора. ## Подробный обзор возможностей LobeHub ### Маркетплейс плагинов LobeHub поставляется с богатым маркетплейсом плагинов (`Settings → Plugins`). Рекомендуемые плагины: * **Web Search** — дает моделям доступ к интернету в реальном времени * **Code Interpreter** — запускает Python прямо в чате для анализа данных и визуализации * **Chart Generation** — автоматически генерирует блок-схемы и ментальные карты * **Image Generation** — генерирует изображения с помощью моделей вроде `gpt-image-1` и `flux-kontext-pro` ### Локальная база знаний (RAG) LobeHub может создать локальное векторное хранилище на основе ваших файлов: 1. Перейдите на страницу `Knowledge Base` и создайте новую базу знаний 2. Загрузите файлы PDF, Markdown, Word, Excel или TXT 3. Система автоматически разбивает их на фрагменты и векторизует 4. В чате выберите базу знаний, и модель ответит, опираясь на ваши файлы На этапе embeddings вызывается embedding-модель (которая тарифицируется). Мы рекомендуем использовать `text-embedding-3-large` от APIYI или аналогичные embedding-модели. ### Мультимодальный чат Загружайте изображения для понимания, распознавания и OCR: * Рекомендуемые vision-модели: `gpt-4o`, `claude-sonnet-4-5`, `gemini-3-pro-image-preview` * Просто перетащите изображение в поле ввода чата, и модель его распознает ### Маркетплейс агентов LobeHub поставляется с богатым набором готовых агентов (перевод, письмо, кодирование, подготовка к собеседованию и т. д.). Также вы можете: * В один клик включить любого агента, которым поделилось сообщество, из `Agent marketplace` * Создать собственного агента — кастомная персона, prompt, открывающая реплика, база знаний и плагины ### Управление беседами * Создавайте ветки бесед, редактируйте сообщения, регенерируйте ответы * Экспортируйте беседы в форматах Markdown, PNG или JSON * Глобальный поиск по истории сообщений ## Расширенные настройки ### Пользовательские параметры запроса Вы можете настроить основные параметры на странице сведений о провайдере: ```yaml theme={null} Default parameters: Temperature: 0.7 # Creativity (reasoning models like gpt-5 / deepseek-r1 must use 1) Top P: 0.9 # Sampling (reasoning models must use 1) Max Tokens: 4096 # Maximum output length Context Length: 8192 # Context window ``` Модели рассуждения (GPT-5, DeepSeek-R1, o1 серия и т. д.) поддерживают только `Temperature = 1` и `Top P = 1`. Другие значения игнорируются или вызывают ошибки на стороне сервера. ### Сетевой прокси и self-hosting Для использования через прокси или в self-hosted LobeHub: 1. **Настольный клиент**: `Settings → Network` для настройки HTTP/HTTPS-прокси 2. **Self-hosted (Docker)**: добавьте конфигурацию APIYI через переменные среды: ```bash theme={null} OPENAI_API_KEY=sk-your-apiyi-key OPENAI_PROXY_URL=https://api.apiyi.com/v1 CUSTOM_MODELS=gpt-5,claude-sonnet-4-5,deepseek-v4-pro ``` 3. **Режим запросов на стороне клиента**: включает прямые запросы из браузера (только если браузер может получить доступ к APIYI) ### Сочетания клавиш | Сочетание клавиш | Действие | | ---------------------- | ------------------ | | `Ctrl/Cmd + N` | Новая беседа | | `Ctrl/Cmd + K` | Быстрый поиск | | `Ctrl/Cmd + /` | Палитра команд | | `Ctrl/Cmd + Shift + M` | Переключить модель | ## Mobile Десктопный клиент LobeHub работает на Windows / macOS / Linux. Для мобильных устройств используйте адаптивное веб-приложение на `lobechat.com` — отдельная установка не требуется. ## Устранение неполадок ### Сбой соединения / проверка подключения не проходит | Симптом | Что проверить | | ---------- | --------------------------------------------------------------------- | | 401 / 403 | Неверный API key или исчерпан баланс — проверьте в консоли APIYI | | 404 | В Proxy URL отсутствует суффикс `/v1` | | Timeout | Проблема с сетью — проверьте прокси или firewall | | CORS error | Отключите `Client-side request mode` или используйте серверный прокси | ### Список моделей пуст * Нажмите **Получить список моделей**, чтобы загрузить его снова * Подождите 1-2 секунды, затем обновите страницу * Убедитесь, что API key активен в консоли APIYI ### Медленный ответ или прерывания потоковой передачи * Переключитесь на более быструю модель (например, `gpt-5-mini`, `claude-haiku-4-5`, `deepseek-v4-flash`) * Отключите ненужные плагины * Проверьте задержку сети * Сократите длинный контекст (закройте устаревшие разговоры) ### Извлечение из базы знаний неточно * Уменьшите размер фрагмента для более точного извлечения * Переключитесь на более сильную embedding model в APIYI * Добавьте больше релевантных документов, чтобы повысить полноту поиска ## Лучшие практики ### Стратегия выбора модели Используйте подходящую модель для соответствующей задачи — выбирайте по сложности: * **Ежедневный чат / простые вопросы и ответы**: `gpt-5-mini`, `claude-haiku-4-5`, `deepseek-v4-flash` * **Сложное рассуждение / анализ длинных документов**: `gpt-5`, `claude-opus-4-5`, `deepseek-v4-pro` * **Кодирование**: `claude-sonnet-4-5`, `gpt-5`, `deepseek-v4-pro` * **Понимание изображений**: `gpt-4o`, `claude-sonnet-4-5`, `gemini-3-pro-image-preview` * **Генерация изображений**: `gpt-image-1`, `flux-kontext-pro` Полный список моделей и сравнение производительности см. на странице [Рекомендации по моделям](/ru/api-capabilities/model-info). ### Управление контекстом * Периодически удаляйте устаревшие разговоры * Разбивайте сложные задачи на более короткие разговоры * Используйте функцию `branch conversation`, чтобы изучать альтернативные ответы ### Безопасность и конфиденциальность * Не публикуйте свой API key * Периодически обновляйте ключи (сброс в один клик в консоли APIYI) * Для чувствительных разговоров используйте self-host LobeHub — данные остаются локально ### Советы по self-hosting * В production используйте Docker + PostgreSQL, а не встроенную БД * Размещайте Cloudflare перед сервисом как обратный прокси * Управляйте secrets через переменные среды для удобного развертывания нескольких экземпляров ## Сравнение с другими клиентами | Функция | LobeHub | ChatBox | Cherry Studio | | --------------------------------------------- | ------------------------ | ------------------------- | ------------------- | | **С открытым исходным кодом и self-hostable** | ✅ | ❌ | ❌ | | **Локальная база знаний (RAG)** | ✅ встроено | ❌ | ❌ | | **Магазин плагинов** | ✅ богатый | ❌ | частично | | **Мультимодальный** | ✅ | ✅ | ✅ | | **Нативные протоколы для нескольких каналов** | ✅ много встроенных | только совместим с OpenAI | ✅ три формата | | **Мобильные устройства** | Адаптивный веб-интерфейс | Нативные приложения | Нативные приложения | | **Кроссплатформенность** | Desktop + web | Desktop + mobile + web | Desktop + mobile | | **Self-hosted** | ✅ Docker/Vercel | ❌ | ❌ | **Когда стоит выбрать LobeHub?** * Вам нужна **локальная база знаний** или **экосистема плагинов** (веб-поиск, интерпретатор кода, диаграммы и т. д.) * Вам нужна **приватная развертка** с полным контролем над данными * Вам нужен один **унифицированный open-source UI** для desktop + web Если для вас важнее **готовый опыт использования и нативные мобильные приложения**, выбирайте ChatBox. Для **родных протоколов Claude / Gemini с экономией за счет кэширования промптов** выбирайте Cherry Studio. Нужна дополнительная помощь? Ознакомьтесь с документацией `lobechat.com` или посетите [сайт APIYI](https://api.apiyi.com).