> ## 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. # Chatbox AI > Руководство по интеграции кроссплатформенного AI-клиентского приложения Chatbox AI — это мощное кроссплатформенное AI-приложение-клиент, которое поддерживает несколько крупных языковых моделей и API. Через APIYI вы можете получить доступ к различным популярным AI-моделям в Chatbox, сохраняя при этом защиту конфиденциальности за счет локального хранения. ## Краткий старт ### Загрузка и установка Chatbox AI поддерживает установку на нескольких платформах: * **Desktop**: Windows, macOS, Linux * **Mobile**: iOS, Android * **Web**: прямой доступ через браузер Посетите [Официальный сайт Chatbox AI](https://chatboxai.app/en), чтобы загрузить версию, подходящую для вашей платформы. ### Настройка APIYI #### Шаг 1: Откройте настройки 1. Запустите приложение Chatbox AI 2. Нажмите на значок настроек (⚙️) в левом нижнем углу 3. Перейдите в интерфейс «Конфигурация модели» #### Шаг 2: Добавьте пользовательского провайдера Интерфейс настроек Chatbox AI - пример настройки APIYI Следуя интерфейсу настройки, показанному выше, выполните следующие шаги: 1. Нажмите кнопку **+ Add** в разделе «Провайдер модели» 2. Заполните информацию о провайдере: * **Название**: APIYI (настраиваемое имя) * **Режим API**: выберите **OpenAI API Compatible** * **API Key**: введите ваш ключ APIYI * **API Host**: `https://api.apiyi.com/v1` * **API Path**: `/chat/completions` (значение по умолчанию) 3. **Дополнительная конфигурация** (необязательно): * Включите опцию «Improve Network Compatibility» (как показано на изображении) * Можно настроить отдельные эндпоинты генерации изображений **Ключевые моменты конфигурации** * Поле API Host соответствует Base URL и должно включать суффикс `/v1` * Поле API Path указывает конкретный путь эндпоинта * API Key можно получить в [консоли APIYI](https://api.apiyi.com) * После настройки нажмите кнопку **+ New** в правом нижнем углу, чтобы добавить модель #### Шаг 3: Выберите модель После завершения настройки вы можете выбрать следующие модели в интерфейсе чата: ## Поддерживаемые модели ### Поддержка моделей Chatbox AI поддерживает различные популярные AI-модели через APIYI, включая: * **Серия GPT**: серия GPT-5, GPT-4o, gpt-4.1, o3 и т. д. * **Серия Claude**: Claude 4 Sonnet, Claude 3.5 Haiku и т. д. * **Серия Gemini**: Gemini 2.5 Pro, Gemini 2.5 Flash и т. д. * **Рекомендуемые модели**: специализированные модели для рассуждения, визуального понимания и генерации кода **Просмотреть полный список моделей** Для получения подробной информации о моделях, тарификации и сравнении функций, пожалуйста, посетите [Страницу информации о моделях](https://docs.apiyi.com/en/api-capabilities/model-info) ## Основные возможности ### Синхронизация между платформами Основные преимущества Chatbox AI: * **Локальное хранение**: данные полностью хранятся локально, что защищает конфиденциальность * **Кроссплатформенный доступ**: переключайтесь между разными устройствами * **Офлайн-функциональность**: некоторые функции поддерживают офлайн-использование ### Управление беседами **Интеллектуальные функции беседы**: * Сохранение контекста многоходовой беседы * Поиск и управление историей бесед * Экспорт бесед (Markdown, PDF) * Библиотека prompt и ссылки на сообщения ### Обработка документов **Возможности понимания документов**: * Загрузка документов PDF, TXT, DOCX * Понимание и анализ изображений * Рендеринг LaTeX и Markdown * Подсветка кода и предпросмотр ### Генерация изображений **Создание изображений с помощью AI**: * Поддерживает генерацию изображений моделями серии DALL-E * Настраиваемые выделенные эндпоинты генерации изображений * Поддерживает различные размеры и стили изображений * Функция пакетной генерации изображений **Настройка генерации изображений**: 1. Добавьте выделенного провайдера генерации изображений в настройках 2. Используйте стандартный эндпоинт `/images/generations` 3. Прямо опишите требования к изображению в чате 4. Система автоматически вызывает API генерации изображений ### Дополнительные настройки **Настройка параметров**: ```yaml theme={null} Conversation Parameter Settings: - Temperature: 0.7 # Creativity control (reasoning models GPT-5 only use 1) - Max Tokens: 4096 # Maximum output length - Top P: 0.9 # Sampling parameter (reasoning models gpt-5 only use 1) - Context Length: 8192 # Context length ``` ## Советы по использованию ### Оптимизация prompt В Chatbox AI есть встроенная библиотека prompt, а также вы можете создавать пользовательские prompt: ```markdown theme={null} # Programming Assistant You are an experienced software engineer, please help me: - Write high-quality code - Explain complex concepts - Provide best practice recommendations # Output Format Please format code using code blocks and provide detailed comments. ``` ### Защита конфиденциальности Chatbox AI придерживается философии «privacy by design»: * Данные хранятся локально, не загружаются в cloud * Поддерживает self-hosted API endpoint * Может использоваться полностью offline (с локальными моделями) ## Расширенная конфигурация ### Пользовательские API-эндпоинты Помимо базовой функции чата, вы также можете настроить выделенные эндпоинты для генерации изображений: #### Конфигурация эндпоинта Chat Completion ```yaml theme={null} Basic Chat Configuration: Provider Name: APIYI API Mode: OpenAI API Compatible API Key: sk-your-apiyi-key API Host: https://api.apiyi.com/v1 API Path: /chat/completions ``` #### Конфигурация эндпоинта генерации изображений **Способ 1: используйте выделенный Image API** ```yaml theme={null} Image Generation Configuration: Provider Name: APIYI-Image API Mode: OpenAI API Compatible API Key: sk-your-apiyi-key API Host: https://api.apiyi.com/v1 API Path: /images/generations # Standard image generation endpoint Applicable Models: gpt-image-1, flux-kontext-pro ``` **Способ 2: используйте эндпоинт Responses** ```yaml theme={null} Responses Configuration: Provider Name: APIYI-Responses API Mode: OpenAI API Compatible API Key: sk-your-apiyi-key API Host: https://api.apiyi.com API Path: /v1/responses # General response endpoint ``` **Рекомендации по выбору эндпоинта** * Обычные разговоры: используйте эндпоинт `/chat/completions` * Модели генерации изображений, полученные обратной разработкой, такие как sora\_image: используйте эндпоинт `/chat/completions` * Генерация изображений: отдавайте приоритет стандартному эндпоинту `/images/generations` * Особые потребности: можно использовать эндпоинт `gpt-image-1` или `/v1/responses` * В Chatbox поле «API Path» соответствует конкретному пути эндпоинта ### Настройки сетевого прокси Если вам нужно использовать прокси для доступа: 1. Перейдите в Settings > Network Configuration 2. Настройте HTTP/HTTPS-прокси 3. Укажите аутентификацию прокси (при необходимости) ### Настройки сочетаний клавиш Распространенные сочетания: * `Ctrl/Cmd + N`: Новый разговор * `Ctrl/Cmd + T`: Переключить модель * `Ctrl/Cmd + /`: Показать палитру команд * `Ctrl/Cmd + K`: Быстрый поиск ## Мобильная конфигурация ### Конфигурация для iOS/Android Мобильная конфигурация такая же, как и на компьютере: 1. Скачайте мобильное приложение Chatbox AI 2. Перейдите в Settings > Model Configuration 3. Добавьте пользовательского провайдера APIYI 4. Настройте тот же API Base URL и ключ ### Функции для мобильных устройств * **Голосовой ввод**: поддерживает преобразование речи в текст * **Интеграция с камерой**: делайте фотографии напрямую для анализа изображений * **Офлайн-кэш**: история переписки доступна офлайн * **Push-уведомления**: оповещения о важных сообщениях ## Устранение неполадок ### Распространенные проблемы **Сбой подключения** * Проверьте API Base URL: `https://api.apiyi.com/v1` * Убедитесь, что API key действителен * Подтвердите, что сетевое подключение работает нормально **Модели не отображаются** * Подождите, пока список моделей обновится автоматически * Вручную нажмите кнопку «Обновить модели» * Проверьте права доступа API key **Медленный ответ** * Попробуйте переключиться на более быструю модель * Проверьте задержку сети * Уменьшите длину контекста ### Отладка журналов Включите режим отладки: 1. Settings > Advanced Options 2. Включите «Debug Mode» 3. Просмотрите подробную информацию журнала ### Резервное копирование данных Регулярно выполняйте резервное копирование данных переписки: 1. Settings > Data Management 2. Экспортируйте историю переписки 3. Создайте резервную копию конфигурационных файлов ## Лучшие практики ### Оптимизация производительности 1. **Выбирайте модели с умом** * Для простых задач используйте gpt-4.1 * Для сложных задач используйте o3, серию gpt-5 * Для длинных текстов используйте Claude 4, серию gemini-2.5-pro 2. **Управление контекстом** * Регулярно очищайте неиспользуемые беседы * Разумно задавайте длину контекста * Используйте функцию группировки бесед 3. **Управление ресурсами** * Отслеживайте использование API * Настройте напоминания о квоте использования * Регулярно обновляйте версию приложения ### Рекомендации по безопасности * Не делитесь ключами API * Регулярно меняйте ключи * Защищайте приложение надежными паролями * Осторожно обращайтесь с конфиденциальной информацией ### Командная работа Хотя Chatbox AI в первую очередь предназначен для индивидуальных пользователей, поддержка команды возможна через: * Обмен шаблонами prompt * Экспорт и обмен записями бесед * Унификацию стандартов конфигурации API ## Преимущества по сравнению ### По сравнению с другими клиентами | Функция | Chatbox AI | Веб-версия ChatGPT | Другие клиенты | | ----------------------------- | ---------- | ------------------ | ------------------- | | **Локальное хранение** | ✅ | ❌ | Частичная поддержка | | **Мультиплатформенность** | ✅ | ❌ | Частичная поддержка | | **Пользовательский API** | ✅ | ❌ | ✅ | | **Офлайн-функции** | ✅ | ❌ | ❌ | | **Защита конфиденциальности** | ✅ | ❌ | Неопределенно | ### Почему стоит выбрать Chatbox AI 1. **Конфиденциальность прежде всего**: данные полностью хранятся локально 2. **Гибкая настройка**: поддерживает различные эндпоинты API 3. **Кроссплатформенность**: единообразный пользовательский опыт 4. **Богатый набор функций**: библиотека prompt, обработка документов и т. д. 5. **Постоянные обновления**: активная разработка и сопровождение Нужна дополнительная помощь? Пожалуйста, ознакомьтесь с [Центром помощи Chatbox AI](https://chatboxai.app/en/help-center) или посетите [Официальный сайт APIYI](https://api.apiyi.com).