Cherry Studio: Claude и GPT через свой API — настройка

Cherry Studio — бесплатный настольный AI-клиент для Windows, macOS и Linux. В нём есть окно чата с ассистентами, выбор модели, базы знаний, инструменты MCP и ответы нескольких моделей рядом. Собственных моделей у Cherry Studio нет: вы подключаете провайдеров по API-ключам, и каждое сообщение оплачивается у этого провайдера.

APIVAI — один из таких провайдеров. Один ключ APIVAI работает с моделями Claude и GPT, в формате OpenAI и в формате Anthropic, с оплатой за токены ниже официальных цен. Поэтому одна запись провайдера в Cherry Studio может дать вам Claude Sonnet 4.6, Claude Opus 5.5 и GPT-5.5 в одном списке моделей.

В Cherry Studio есть два понятных способа подключить APIVAI:

Выбирайте пользовательский провайдер, если хотите держать Claude и GPT рядом с одним ключом; большинству подойдёт именно он. Выбирайте провайдер Anthropic, если пользуетесь только Claude и предпочитаете родной формат, например для функций Cherry Studio, которым нужен endpoint по протоколу Anthropic. Можно настроить оба с одним ключом.

В текущих версиях диалог + Add Provider показывает отдельные поля endpoint (по умолчанию OpenAI и Anthropic, остальные — в More Settings). Документация Cherry Studio не объясняет, как модель выбирает между двумя endpoint одного провайдера, поэтому в этом руководстве там заполняется только OpenAI endpoint, а для родного маршрута Claude используется встроенный провайдер Anthropic. Старые версии вместо этого спрашивают Provider Type — выберите OpenAI.

1. Зарегистрируйтесь на apivai.com по email.
2. Пополните баланс от $10 картой, криптовалютой, Alipay или WeChat Pay. Подписки и бесплатного пробного периода нет: вы платите только за использованные токены.
3. Откройте Панель, создайте ключ и скопируйте его. Ключу можно задать собственный лимит бюджета.

1. Нажмите Settings (значок шестерёнки на левой панели).
2. Откройте вкладку Model Services.
3. Нажмите + Add Provider под списком провайдеров.
4. Заполните диалог по таблице ниже и нажмите Add.

Про /v1: Cherry Studio ждёт базовый адрес и сам добавляет версию и путь, так что https://api.apivai.com превращается в https://api.apivai.com/v1/chat/completions. Текущие версии принимают и https://api.apivai.com/v1 без удвоения, но никогда не вставляйте полный адрес с /v1/chat/completions. Символ # в конце заставляет Cherry Studio использовать адрес ровно как написано; для APIVAI он не нужен.

1. Откройте в списке только что созданного провайдера APIVAI.
2. Нажмите Get model list. Cherry Studio загрузит модели, доступные вашему ключу; нажмите + рядом с каждой нужной. В выборе модели появляются только добавленные модели.
3. Если удобнее ввести вручную, нажмите + и укажите ID модели, например claude-sonnet-4-6, claude-haiku-4-5 или gpt-5.5.

Список моделей со временем меняется, поэтому берите ID из Get model list или со страницы цен, а не со старых скриншотов.

1. Нажмите Test (в некоторых версиях — Check) и выберите модель. Сообщение об успехе значит, что ключ и адрес верны.
2. Включите провайдера переключателем в правом верхнем углу страницы провайдера. Включённый провайдер отмечен в списке зелёной точкой.
3. Откройте чат, выберите модель в выпадающем списке сверху и отправьте сообщение.

В Model Services откройте Anthropic, вставьте ключ APIVAI в API Key и замените API Address с https://api.anthropic.com на https://api.apivai.com. Не добавляйте /v1: адрес имеет ту же форму, что и у Anthropic. Затем нажмите Get model list, добавьте нужные модели Claude и включите провайдера. Модели GPT здесь работать не будут — они идут через пользовательский провайдер из шага 2. Подробнее о формате Anthropic — на странице Claude API proxy.

Цены за 1M токенов на 2026-10-07. Все модели — на странице цен.

Практичная схема: дешёвый ассистент по умолчанию на Claude Haiku 4.5 или GPT-6 Luna, основной — на Claude Sonnet 4.6, а Claude Opus 5.5 — только для вопросов, которым он действительно нужен. Cherry Studio умеет отправлять один вопрос сразу нескольким моделям — это недорогой способ сравнить их на своих задачах.

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

• Обычный чат: допустим, ход — это около 3 000 входных токенов (ваше сообщение плюс недавняя история) и 800 выходных. На Claude Sonnet 4.6 один ход стоит $0.0073 ($0.021 по официальным ценам). При 40 ходах в день в течение 30 дней (1 200 ходов) это $8.76 в месяц против $25.20. Тот же месяц на Claude Haiku 4.5 стоит $2.93, а на GPT-6 Luna — $0.126.
• Работа с длинным документом: вы вставляете отчёт примерно на 30 000 токенов и задаёте 10 уточняющих вопросов; каждый заново отправляет около 31 000 входных токенов и возвращает 1 500 выходных. На Claude Sonnet 4.6 такая сессия стоит $0.401 ($1.16 по официальным ценам).

Чтобы тратить меньше, начинайте новую тему, когда меняется предмет разговора, и выдайте Cherry Studio отдельный ключ с лимитом бюджета. В Панели виден каждый запрос с токенами и стоимостью. Более широкое сравнение цен — в статье Сравнение цен Claude API.

Чат полностью работает через APIVAI, но базам знаний нужна embedding-модель для индексации файлов, а APIVAI embeddings не предоставляет. Чтобы пользоваться базой знаний, настройте для неё в Cherry Studio отдельного embedding-провайдера; отвечать при этом может модель Claude или GPT из APIVAI. Модели генерации изображений через APIVAI тоже недоступны.

• 401 или «invalid API key»: ключ скопирован не полностью, удалён или исчерпал лимит бюджета. Скопируйте его заново из Панели и проверьте баланс.
• 404: неверный адрес. Для пользовательского провайдера укажите https://api.apivai.com без /chat/completions и без # в конце. Для провайдера Anthropic — https://api.apivai.com без /v1.
• Модель не найдена: ID должен совпадать точно, например claude-sonnet-4-6, а не отображаемое название. Через Get model list видно, что доступно ключу. Модели GPT не работают в провайдере Anthropic — добавьте их в пользовательский провайдер.
• Модели нет в выборе в чате: провайдер выключен, или вы загрузили список, но не нажали + рядом с моделью.
• Пустые или обрезанные ответы: токены размышлений входят в лимит вывода. В Edit Assistant → вкладка Model выключите Enable message length limit (MaxToken) или поставьте 4096 и больше.
• Ответ приходит целиком или поток обрывается: проверьте переключатель Streaming output (Stream) на той же вкладке и настройки прокси в сетевых параметрах Cherry Studio.
• 429: по умолчанию 60 запросов в минуту на ключ. Сравнение нескольких моделей сразу тратит несколько запросов; подождите немного или попросите поддержку повысить лимит.

Все endpoint и коды ошибок описаны в документации.

Для Claude и GPT вместе используйте пользовательский провайдер с OpenAI endpoint. Встроенный провайдер Anthropic нужен, только если вы хотите Claude в родном формате Anthropic.

Не нужно. Введите https://api.apivai.com — Cherry Studio сам добавит /v1 и путь запроса. Никогда не вводите полный адрес с /v1/chat/completions.

Да. Один ключ APIVAI работает со всеми моделями со страницы цен и в обоих форматах. Тот же ключ подходит для Chatbox и других OpenAI-совместимых инструментов.

Нет. Содержимое запросов и ответов не логируется; для биллинга сохраняются только данные об использовании: модель, число токенов и стоимость. История чатов остаётся в Cherry Studio на вашем компьютере.

Нет. Оплата предварительная, по факту использования, пополнение от $10, без подписки.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в Cherry Studio.