Подключение AionUi
Сложность 🧩 Средняя | Формат API Совместимый с OpenAI | base_url
https://byesu.com/v1
https://byesu.com/v1gpt-5.5AionUi — это бесплатное, локальное приложение с открытым исходным кодом для совместной работы (Cowork) с графическим интерфейсом и удалённым WebUI. Оно позволяет одновременно запускать несколько ИИ-агентов: Gemini CLI, Claude Code, Codex и другие. Подключив к нему модели Byesu API, вы сможете в одном интерфейсе совместно решать задачи с помощью таких моделей, как gpt-5.5, claude-opus-4-8, gemini-3.1-pro-high.
Прежде чем начать
Сначала перейдите в Консоль → Токены и создайте API-токен (вида sk-xxxx).
При создании обязательно выберите правильную группу — от группы зависит, какие модели вам доступны и по какой цене они тарифицируются. Не уверены, какую выбрать? Смотрите Выбор группы.
Шаг 1: Скачивание и установка AionUi
Перейдите на страницу GitHub Releases и скачайте установочный пакет для вашей системы:
- Адрес для скачивания: https://github.com/iOfficeAI/AionUi/releases
- Для Windows выберите
.exe, для macOS —.dmg, для Linux —.AppImage.
После скачивания дважды щёлкните по файлу, чтобы установить и открыть AionUi.
Шаг 2: Добавление модели Byesu API
AionUi использует единую конфигурацию моделей для подключения к сервисам, совместимым с OpenAI, к которым относится и Byesu API.
- Откройте AionUi и перейдите на страницу Настройки (Settings).
- Переключитесь на вкладку Конфигурация моделей (Model Configuration).
- Нажмите Добавить модель (Add Model).
- В качестве типа поставщика выберите NewAPI (или Совместимый с OpenAI / Custom).
- Заполните поля согласно таблице ниже:
| Поле | Что вписать |
|---|---|
| Адрес API (API Address / base_url) | https://byesu.com/v1 |
| Ключ API (API Key) | Ваш токен sk-xxxx |
| Модель (Model) | См. рекомендации ниже |
| Протокол запросов (Request Protocol) | Выберите OpenAI (совместимый); если после добавления модели claude / gemini возникает ошибка протокола или формата, вручную переключите протокол под конкретную модель |
base_url должен заканчиваться на /v1
Для формата, совместимого с OpenAI, необходимо указать https://byesu.com/v1 — не пропускайте /v1, не добавляйте в конце лишнюю косую черту или /chat/completions.
После ввода ключа выберите нужную модель из выпадающего списка; если список пуст, имя модели можно ввести вручную. Часто используемые модели:
| Назначение | Имя модели |
|---|---|
| Общение / написание текстов | gpt-5.5 |
| Программирование / рассуждения с длинным контекстом | claude-opus-4-8 |
| Мультимодальность / сверхбольшой контекст | gemini-3.1-pro-high |
Сохраните конфигурацию.
Шаг 3: (Опционально) Настройка агента Claude Code
Каждый ИИ-агент в AionUi настраивается независимо. Агент Claude Code работает через нативный интерфейс Anthropic, и его base_url отличается от совместимого с OpenAI — он без /v1:
Base URL: https://byesu.com
API Key: sk-xxxx
Model: claude-opus-4-8ANTHROPIC_BASE_URL=https://byesu.com
ANTHROPIC_AUTH_TOKEN=sk-xxxx
ANTHROPIC_MODEL=claude-opus-4-8Другие агенты, такие как Gemini CLI, Codex и прочие, настраиваются аналогично: в их собственных настройках укажите соответствующий base_url (для совместимого с OpenAI — https://byesu.com/v1), ключ и модель.
Шаг 4: Запуск и проверка
Вернитесь в интерфейс чата, выберите вверху в меню выбора модели только что настроенную модель (например, gpt-5.5) и отправьте фразу «Привет, расскажи о себе в одном предложении».
Если вы получили нормальный ответ, значит подключение прошло успешно. Если вы используете агент Claude Code, можете попросить его прочитать какой-нибудь файл или выполнить простую задачу, чтобы убедиться, что агент работает корректно.
Застряли?
- 401 / Недействительный токен: проверьте, что API Key вставлен полностью и без лишних пробелов; убедитесь, что используете
sk-xxxx, созданный в консоли Byesu. Подробнее см. Частые ошибки #auth. - Сообщение об отсутствии доступного канала / модель не существует: чаще всего это означает, что для токена выбрана неправильная группа или указанная модель не поддерживается текущей группой. Смените группу или имя модели, см. Выбор группы и Частые ошибки #no-channel.
- Недостаточно средств: при исчерпании баланса на счёте запросы будут отклоняться — пополните счёт или смените группу. См. Частые ошибки #balance.
- Нет соединения / 404: убедитесь, что для совместимого с OpenAI указан
https://byesu.com/v1, а для агента Claude Code —https://byesu.com(без/v1).
Дополнительные способы устранения неполадок см. в разделе Частые ошибки.
