Wokey API в Claude Desktop

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

vpn_key

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

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

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

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

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

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

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

terminal

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

Направьте запросы клиента в Wokey с помощью конфигурации ниже.

Claude Desktop

Для Claude Desktop нужна последняя версия приложения; сторонний инференс настраивается в режиме разработчика. Выполните шаги слева.

  1. 1

    Установите последнюю версию Claude Desktop

    Сначала обновитесь до последней версии: в старых версиях может не быть режима разработчика и настроек стороннего инференса.

  2. 2

    Откройте приложение, не входя в аккаунт

    Запустите Claude Desktop и на время первоначальной настройки не входите в аккаунт.

  3. 3

    Включите режим разработчика

    Откройте меню в правом верхнем углу и выберите Help → Troubleshooting → Enable developer mode.

  4. 4

    Откройте настройки стороннего инференса

    После включения режима разработчика откройте меню Claude и выберите Developer → Configure third-party inference.

  5. 5

    Укажите подключение к Wokey

    Для Connection выберите Gateway, для Credential kind — Static API key. Введите Base URL Wokey и свой API-ключ Wokey.

  6. 6

    Примените и перезапустите

    Нажмите Apply Changes, затем Save & Restart. После перезапуска начинайте работу, не входя в аккаунт Anthropic: при входе запросы будут уходить напрямую в Anthropic.

Claude Desktop
Connection: Gateway
Credential kind: Static API key
URL: https://api.wokey.ai
API key: YOUR_API_KEY

Apply: Apply Changes → Save & Restart
task_alt

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

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

Claude Desktop по умолчанию использует формат Anthropic Messages. Ответ 200 на этот запрос означает, что ключ и Base URL указаны верно. Перед отправкой замените YOUR_API_KEY на свой ключ.

cURL
curl https://api.wokey.ai/v1/messages \
  -H "x-api-key: YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello" }
    ]
  }'
troubleshoot

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

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

401

invalid api key

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

402

insufficient balance

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

429

rate limited

Слишком частые запросы. Повторите позже или снизьте параллелизм.

502

upstream unavailable

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

504

upstream timeout

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

529

upstream overloaded

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