Настройка Cherry Studio

Эта страница про мобильное приложение Cherry Studio для iOS и Android. Приложение в разработке, поэтому названия кнопок могут сдвигаться. Ориентируйтесь на предпросмотр адреса запроса в форме настройки.

Настольное приложение — отдельный продукт. Сопряжение может перенести настройки подключения. Историю чата оно не переносит.

Достаточно одного ключа Nexus. Каждый протокол — отдельная запись подключения в приложении, а не второй аккаунт Nexus. Общий порядок — на странице подключения клиентов.

Значения

Запись	Что выбрать	База для первой попытки	Что должен показать предпросмотр
Chat	OpenAI Chat	https://api.nexus-hub.tech	https://api.nexus-hub.tech/v1/chat/completions
Responses	OpenAI Responses	https://api.nexus-hub.tech	https://api.nexus-hub.tech/v1/responses
Messages	Anthropic Messages	https://api.nexus-hub.tech	https://api.nexus-hub.tech/v1/messages
Gemini	Gemini Generate Content	https://api.nexus-hub.tech	путь с /v1beta/models/ и generateContent

Если в предпросмотре нет /v1 или путь операции повторён дважды, меняйте только базу, пока предпросмотр не совпадёт с таблицей. Для Chat и Responses обычно нужна база https://api.nexus-hub.tech/v1. Для Messages базу оставляют без /v1. Для Gemini в предпросмотре должен быть /v1beta, а не только /v1.

Форма отклоняет полный путь операции, строку запроса и ключ внутри URL. Не добавляйте # в конец. Этот знак отключает вставку версии, а Nexus нужен обычный путь с версией.

Шаги

1. Создайте API-ключ Nexus в Telegram-боте.
2. В приложении откройте настройки службы моделей и добавьте свою запись с именем Nexus.
3. Выберите OpenAI Chat. Укажите базовый URL из таблицы и прочитайте предпросмотр адреса до сохранения.
4. Вставьте ключ без приставки Bearer и без пробелов.
5. Синхронизируйте модели или введите точный id из GET /v1/models для этого ключа.
6. Включите запись и отправьте короткое сообщение.
7. Добавьте вторую запись для Anthropic Messages. Предпросмотр должен заканчиваться на /v1/messages.
8. Третью запись для Gemini добавляйте только если нужен этот формат. В предпросмотре должны быть /v1beta/models/ и generateContent.
9. Запись Responses добавляйте только когда явно выбираете этот интерфейс. Предпросмотр должен заканчиваться на /v1/responses.

Инструменты, вложения и изображения работают только если каталог разрешает их для этого id и маршрута. Id из Chat сам по себе не действует на Messages или Gemini.

Проверка

Отправьте одно короткое сообщение в только что включённой записи. Обычный ответ значит, что запись работает. Повторите проверку после добавления Messages или Gemini.

Если не работает

• 401 или invalid_key: в поле ключа лишние пробелы, приставка Bearer или отозванный ключ.
• model_not_found или model_not_allowed: этого id нет в GET /v1/models для ключа.
• unsupported_model: id виден, но не на этом протоколе. Откройте запись, чей предпросмотр совпадает с семейством маршрута, или выберите другой id.
• 404: предпросмотр не совпадает ни с одним из четырёх адресов в таблице. Не вставляйте путь операции в поле базы.

В поддержку отправьте маршрут, код ошибки, время и x-request-id. Ключ и полный текст запроса не отправляйте.

Официальное приложение: Cherry Studio для iOS и Android.