Клиенты/Cherry Studio

Wokey API в Cherry Studio

Получите API-ключ Wokey, укажите в Cherry Studio base URL Wokey и проверьте подключение одним curl-запросом.

Обновлено

На этой страницеexpand_more

Получите API-ключ и Base URLlink

Все клиенты используют один и тот же API-ключ Wokey и один и тот же Base URL.

Создайте API-ключ

Войдите и создайте ключ платформы на странице API. Ключи одного аккаунта используют общий баланс.

Создать API-ключkey

Используйте Base URL Wokey

Укажите в качестве Base URL клиента домен шлюза; из конфигурации ниже видно, нужно ли добавлять /v1.

Настройте клиентlink

В Cherry Studio пользовательские провайдеры добавляются в разделе провайдеров моделей. Эндпоинта OpenAI достаточно, чтобы вызывать все модели Wokey через Chat Completions; тому же провайдеру можно указать и эндпоинт Anthropic.

  1. 1

    Добавьте провайдера

    Откройте настройки → провайдеры моделей, нажмите кнопку добавления провайдера внизу списка и укажите имя Wokey. В старых версиях также спрашивается тип провайдера: выберите OpenAI.

  2. 2

    Укажите адрес и ключ

    В настройках эндпоинтов в поле OpenAI введите https://api.wokey.ai без /v1, в поле ключа вставьте API-ключ Wokey и подтвердите добавление. Под полем показывается итоговый путь запроса.

  3. 3

    Добавьте модели

    Нажмите кнопку получения списка моделей или «+» рядом с ней, чтобы ввести ID модели вручную, например claude-opus-5-5.

  4. 4

    Проверьте и используйте

    Нажмите кнопку проверки справа от ключа API и убедитесь, что переключатель в правом верхнем углу страницы провайдера включён. Затем выберите модель Wokey в верхней части окна чата.

Cherry Studio
Имя провайдера: Wokey
Эндпоинт OpenAI: https://api.wokey.ai
Ключ API: YOUR_API_KEY
ID модели: claude-opus-5-5

Форматы API и Base URLlink

Когда клиент переключается на другой формат API, наличие /v1 в Base URL может измениться.

ФорматBase URLДля чего
OpenAI Chat Completionshttps://api.wokey.aiDeepSeek, GLM, Kimi и другие модели
Anthropic Messageshttps://api.wokey.aiМодели Claude

Где настраивается: Настройки → Провайдеры моделей → добавить провайдера

Проверка через curllink

Если клиент выдаёт ошибку, сначала исключите проблемы с ключом и Base URL с помощью curl.

Cherry Studio по умолчанию использует формат OpenAI Chat Completions. Ответ 200 на этот запрос означает, что ключ и Base URL указаны верно. Перед отправкой замените YOUR_API_KEY на свой ключ.

cURL
curl https://api.wokey.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-5-5",
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'

Ошибки и устранение неполадокlink

Сначала отделите ошибки авторизации, баланса, ограничения частоты запросов, недоступности модели и таймаута на стороне апстрима.

401

invalid api key

Ключ отсутствует, указан с ошибкой, удалён, либо заголовки Authorization / x-api-key противоречат друг другу.

402

insufficient balance

Недостаточно средств на балансе. Пополните баланс, чтобы продолжить отправлять запросы.

403

model_denylisted / account_restricted

Вызовы модели или всех моделей аккаунта приостановлены после повторных нарушений. Подробнее — в разделе «Сбор за нарушения и ограничения».

403

request_blocked

Запрос заблокирован до отправки в апстрим и не оплачивается: например, повторная отправка без изменений запроса, который модель только что отклонила, или приостановленный конечный пользователь (X-End-User-Id). В сообщении об ошибке указано, что именно заблокировано; измените запрос по подсказке или повторите попытку позже. Другие запросы это не затрагивает.

429

rate limited

Слишком частые запросы. Повторите позже или снизьте параллелизм. Если 429 постоянно возвращается только для одной модели или одного конечного пользователя (X-End-User-Id), это может быть временное ограничение после нарушений.

499

client disconnected

Клиент закрыл соединение до завершения ответа (code downstream_aborted). По умолчанию это бесплатно. Если за последние 24 часа у аккаунта не меньше 50 отключений клиента и они составляют 10% запросов или больше, последующие прерванные запросы оплачиваются по данным апстрима: обработанный ввод, включая чтение и запись кэша, а вывод — только если апстрим его подсчитал. Отключение до того, как апстрим сообщил об использовании, остаётся бесплатным. Аккаунт получает уведомление, когда оплата начинается, а когда доля отключений возвращается в норму, оплата автоматически прекращается в течение часа. Обычно причина — слишком короткий тайм-аут клиента или прокси либо программа, которая отменяет запросы до их завершения.

502

upstream unavailable

Сервис модели на стороне апстрима временно недоступен. Переключитесь на другую модель или повторите позже.

504

upstream timeout

Истекло время ожидания ответа апстрима. Сократите контекст, уменьшите max_tokens или повторите запрос.

529

upstream overloaded

Модель на стороне апстрима временно перегружена; Wokey уже повторил запрос по другим маршрутам (code upstream_overloaded). С вашим балансом это не связано. Повторите чуть позже или переключитесь на другую модель.

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

Нужно ли добавлять /v1 в адрес API в Cherry Studio?
Нет, укажите https://api.wokey.ai. Cherry Studio сам добавляет /v1/chat/completions и показывает итоговый путь запроса под полем, так что его можно проверить перед сохранением.
Какой эндпоинт заполнять: OpenAI или Anthropic?
Эндпоинта OpenAI достаточно для вызова моделей через Chat Completions. Чтобы отправлять запросы к моделям Claude в формате Anthropic Messages, укажите у того же провайдера и эндпоинт Anthropic: https://api.wokey.ai. В старых версиях вместо настроек эндпоинтов выбирается тип провайдера: выберите OpenAI.
Почему список моделей пуст?
У нового провайдера моделей нет. Нажмите кнопку получения списка моделей, чтобы загрузить его из Wokey, или «+» рядом с ней, чтобы ввести ID модели вручную, например claude-opus-5-5.
Что делать, если проверка подключения возвращает 401?
Вставьте в поле ключа API только сам ключ, без префикса Bearer, пробелов и переносов строк. Затем убедитесь, что ключ не удалён и не приостановлен, а на счёте есть баланс.