Wokey API в Hermes Agent

Получите API-ключ Wokey, укажите в Hermes Agent 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 с помощью конфигурации ниже.

Hermes Agent

Hermes Agent достаточно первых пяти строк конфигурации: модель, custom provider, Base URL и API-ключ. Для моделей GPT (например, gpt-6-sol) добавьте api_mode: codex_responses — так доля попаданий в кэш будет максимальной; для других моделей, например Claude, эту строку не добавляйте.

Hermes Agent
# ~/.hermes/config.yaml
model:
  default: claude-opus-5-5
  provider: custom
  base_url: https://api.wokey.ai
  api_key: YOUR_API_KEY
  # Только для моделей GPT (например, gpt-6-sol): раскомментируйте для максимальной доли попаданий в кэш
  # api_mode: codex_responses
task_alt

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

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

Hermes Agent по умолчанию использует формат 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": "gpt-6-sol",
    "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). С вашим балансом это не связано. Повторите чуть позже или переключитесь на другую модель.