Cherry Studio собирает нескольких поставщиков моделей в одном настольном клиенте. Это удобно, но управление ключами легко упустить: кто создал ключ, какие модели он открывает, где хранится, попадёт ли в резервную копию, продолжает ли использоваться после увольнения сотрудника. Ниже — последовательность действий: создание, настройка, хранение, синхронизация, ротация, права и диагностика.

Примечание: Cherry Studio — товарный знак CherryHQ. Материал носит технический характер и не означает подчинения или сотрудничества с CherryHQ. Названия пунктов меню, способ хранения и расположение функций могут меняться от версии к версии; сверяйтесь с текущим клиентом и официальной документацией. Модели и цены — на странице цены на модели.

1. Разделите три типа «ключей Cherry Studio»

Термин часто используют вперемешку:

  • Учётные данные клиента или корпоративной платформы — для входа, управления Enterprise-версией или собственных сервисов производителя; права и оплату определяет производитель.
  • Ключи поставщиков моделей — выпускаются OpenAI, Anthropic, Google и другими и вписываются в поле соответствующего провайдера.
  • Ключи шлюза — выпускаются OpenAI-совместимым сервисом вроде ZSQH AI Gateway; один ключ даёт доступ к моделям нескольких поставщиков.

Здесь речь о третьем типе. Он не используется для входа в Cherry Studio и не открывает интерфейсы производителя клиента. При настройке выбирайте «собственный провайдер» или OpenAI-совместимую точку входа, а не вставляйте ключ шлюза в поле, предназначенное для конкретного вендора.

2. Создание ключа: сначала назначение и лимит

Не создавайте ключ, а потом думайте, кому его отдать: обратный порядок экономит время.

  1. Откройте страницу регистрации ZSQH AI Gateway, зарегистрируйтесь и войдите в консоль.
  2. Перейдите в раздел API-ключей и создайте новый ключ.
  3. В названии укажите пользователя, устройство и назначение, например cherry-laptop-daily, а не test.
  4. Задайте лимит и срок действия; если консоль поддерживает ограничение по моделям, ограничьте список под проект.
  5. Проверьте баланс, чтобы не обнаружить проблему уже после настройки.
  6. Скопируйте ключ в менеджер паролей; не отправляйте его сначала в чат, документ или тикет.

После создания проверьте связку «ключ — адрес — модель» в командной строке и только потом переходите в клиент:

export ZSQH_API_KEY="sk-ваш-ключ"

curl "https://ai.zhongshangqihang.com/v1/chat/completions" \
  -H "Authorization: Bearer $ZSQH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"ваш-ID-модели","messages":[{"role":"user","content":"Ответь только OK"}]}'

Если в ответе есть поле choices, цепочка запроса работает. При 401 проверьте ключ, при 404 — путь /v1, при сообщении о несуществующей модели — её ID.

3. Настройка провайдера и моделей в клиенте

В Cherry Studio вход обычно находится в разделе «Настройки → Модельные сервисы». Названия кнопок в разных версиях отличаются, но поля почти одинаковые:

Параметр Что указать Пояснение
Тип провайдера Собственный / OpenAI-совместимый Не выбирайте фирменный протокол вендора
API-ключ sk-... Ключ шлюза, созданный в консоли
Адрес API https://ai.zhongshangqihang.com/v1 Без слэша в конце
Модель Получить из списка или добавить вручную ID должен совпадать со страницей цен

После сохранения можно нажать «Получить список моделей» или добавить ID вручную. В ID учитывайте регистр и суффикс версии, а тип укажите по назначению: диалог, эмбеддинги, зрение. Конкретный набор опций зависит от версии. Проверьте конфигурацию кнопкой проверки или коротким запросом «Ответь только OK».

4. Как распределить несколько моделей

Мультимодельность — не про заполнение списка, а про разделение задач между ассистентами:

  • Повседневные вопросы — быстрая универсальная модель с контролируемой стоимостью.
  • Длинные тексты и договоры — модель с большим контекстом в отдельном ассистенте, чтобы не смешивать с обычными диалогами.
  • Код и структурированный вывод — модель со стабильными навыками программирования; проверьте поддержку нужных параметров.
  • База знаний — отдельно настроенная модель эмбеддингов; при необходимости добавьте модель переранжирования.
  • Чувствительные данные — локальная модель или заранее определённые границы обработки.

Каждому ассистенту пропишите системный промпт, чтобы не повторять вводные. Чем больше моделей, тем важнее не вставлять один и тот же документ в диалог снова и снова: то, что можно положить в базу знаний, лучше туда и поместить.

5. Где хранятся ключи и что учесть при копировании

Cherry Studio хранит настройки провайдеров и ключи в локальных данных приложения. Официальная документация не обещает шифрование локального хранилища, поэтому относитесь к этим данным как к чувствительным: включите шифрование диска и пароль блокировки экрана, не размещайте каталог приложения в публичном облаке или репозитории.

Для резервного копирования документация перечисляет WebDAV, S3-совместимое хранилище и локальный каталог. Полная копия включает чаты, ассистентов, базу знаний, вложения и настройки провайдеров, а также API-ключи; облегчённая копия меньше по размеру, но не позволяет полностью восстановить базу знаний. Синхронизация между устройствами в реальном времени в документации не описана; распространённый сценарий — копия на компьютере A и восстановление на компьютере B.

Отсюда правила:

  • Файлы копий храните как ключевые файлы, не передавайте и не кладите в недоверенное общее облако.
  • Для каждого устройства создавайте свой ключ, не копируйте один на все машины.
  • Перед переездом сделайте полную копию, после восстановления проверьте провайдеров, модели и базу знаний.
  • На общих компьютерах используйте отдельные системные учётные записи, чтобы настройки не перезаписывали друг друга.

6. Ротация и отзыв

Рекомендуется менять ключ раз в 90 дней или немедленно при увольнении сотрудника, потере устройства и подозрении на утечку. Порядок «сначала новый, затем переключение, только потом отключение старого» — не наоборот.

  1. Создайте новый ключ с теми же правами и добавьте в название дату.
  2. Замените API-ключ в Cherry Studio и проверьте каждую запись провайдера.
  3. Отправьте тестовый запрос и убедитесь, что в журнале шлюза появился вызов с новым ключом.
  4. Понаблюдайте за ошибками и расходом, чтобы не пропустить забытый скрипт или устройство.
  5. Отключите старый ключ и удалите его только спустя некоторое время.

Cherry Studio позволяет задать несколько ключей для одного провайдера и чередовать их, что помогает распределять нагрузку при лимитах; но это не означает, что ключ можно сделать общим — учёт и ответственность всё равно нужно разделять.

7. Минимальные права и командные правила

  • Один человек — один ключ, одно назначение — один ключ; для автоматизации создавайте отдельный.
  • Если можно задать лимит, срок и список моделей, задайте всё; как минимум первые два.
  • Подключайтесь через единый шлюз, чтобы сохранять журналы пользователей, моделей и расхода для сверки.
  • Ведите реестр: название ключа, владелец, назначение, дата создания и окончания. Полный ключ в реестр не записывайте.
  • Ежемесячно проверяйте давно неиспользуемые и превысившие лимит ключи, а также всплески ошибок авторизации.
  • Включите создание, передачу и отключение ключей в процессы приёма и увольнения.
  • Определите, какие данные допустимо отправлять в облачные модели; чувствительные проекты оценивайте заранее.
  • Периодически сверяйте цены на модели: тарифы и доступность меняются.

8. Диагностика

  • 401 / Invalid API Key: ключ неверен, отключён или при вставке попали пробел или перевод строки.
  • 403: закончился лимит, не хватает прав или модель не входит в разрешённый список.
  • 404: неверный путь адреса; проверьте, не дублируется ли /v1 и не пропущен ли он.
  • 429: сработало ограничение частоты или достигнут лимит; смотрите расход в консоли.
  • Тайм-аут или обрыв: проверьте прокси, межсетевой экран и настройки потокового вывода.
  • Ошибка базы знаний: не настроена модель эмбеддингов или шлюз не предоставляет нужный интерфейс.
  • После восстановления копии ничего не работает: убедитесь, что настройки провайдера восстановлены, затем заново впишите или проверьте ключ.
  • После смены ключа ошибка осталась: проверьте, что настройки сохранены, и сверьте в журнале шлюза, доходит ли запрос.

Частые вопросы

Где Cherry Studio хранит API-ключ и насколько это безопасно?

В локальных данных приложения; путь зависит от системы и версии. Документация не обещает шифрование, а полная копия включает ключи. Защищайте данные как чувствительные, включайте шифрование диска и не синхронизируйте их в публичные места.

Можно ли одним ключом пользоваться несколькими моделями?

Обычно да, если шлюз разрешает этому ключу вызывать такие модели. Возможность ограничить список зависит от консоли; если ограничения нет, используйте хотя бы лимит, срок действия и журналы.

Попадут ли ключи в резервную копию WebDAV?

Официальная документация указывает, что полная копия содержит настройки провайдеров и API-ключи. Выбирайте доверенное хранилище, включайте шифрование канала и не передавайте файл копии. Если ключи особенно чувствительны, рассмотрите облегчённую копию или удаление ключей перед копированием.

Как перенести настройки и ключи на другой компьютер?

Сделайте полную копию, загрузите её в WebDAV или S3 и восстановите на новом устройстве; можно перенести и локальный каталог копии. После восстановления проверьте провайдеров, модели, базу знаний и модель по умолчанию, а для нового устройства создайте отдельный ключ.

Что делать в первую очередь при утечке ключа?

Отключите или удалите ключ, чтобы остановить потери, затем проверьте аномальный расход, источники и время вызовов. После этого просмотрите копии, репозитории, переписку и скриншоты и при необходимости смените остальные учётные данные того же окружения.

Итог

Настройка ключей в Cherry Studio несложна; сложность в долгом управлении: прослеживаемые имена, лимиты, защищённое хранение, понятные границы копий и возможность быстро остановить утечку. Можно зарегистрироваться в ZSQH AI Gateway, создать отдельный ключ для клиента, а после успешного запуска ужесточить правила под команду и регулярно сверять расход на странице цены на модели.

Полезное чтение: