Get a Wokey API key, point Hermes Agent at the Wokey base URL, then confirm the connection with one curl request.
Every client uses the same Wokey API key and the same base URL.
Sign in and create a platform key on the API page. Keys in one account share its balance.
Create an API keykeySet the client base URL to the gateway domain; the configuration below shows whether to append /v1.
Point the client at Wokey with the configuration below.
Hermes Agent only needs the first five config lines for model, custom provider, Base URL, and API key. For GPT models (such as gpt-6-sol), add api_mode: codex_responses for the best cache hit rate; leave it off for other models such as Claude.
# ~/.hermes/config.yaml
model:
default: claude-opus-5-5
provider: custom
base_url: https://api.wokey.ai
api_key: YOUR_API_KEY
# GPT models (such as gpt-6-sol) only — uncomment for the best cache hit rate:
# api_mode: codex_responsesIf the client reports an error, rule out the key and base URL with curl first.
Hermes Agent uses the OpenAI Chat Completions format by default. A 200 from this request means the key and base URL are right. Replace YOUR_API_KEY with your key before sending it.
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" }
]
}'Separate auth, balance, rate limit, model availability, and upstream timeout cases first.
The key is missing, mistyped, deleted, or Authorization / x-api-key headers conflict.
The account balance is too low. Top up before sending more requests.
Traffic is too frequent. Retry later or reduce concurrency.
The upstream model service is temporarily unavailable. Switch models or retry later.
The upstream response timed out. Shorten context, reduce max_tokens, or retry.
The official upstream route is out of quota. Wait for routing recovery or switch models.