O base_url do Hermes Agent deve terminar em /v1?

Não. Defina base_url como https://api.wokey.ai e provider como custom.

Quando adiciono api_mode: codex_responses?

Apenas com modelos GPT como gpt-6-sol, em que ele dá a melhor taxa de acerto de cache. Deixe de fora para Claude e outros modelos.

Onde fica a chave de API?

No campo api_key em model no ~/.hermes/config.yaml, apenas a chave.

Clientes/Hermes Agent

Use a API da Wokey com o Hermes Agent

Obtenha uma chave de API da Wokey, aponte o Hermes Agent para a base URL da Wokey e confirme a conexão com uma requisição curl.

Atualizado 2026-11-10

Nesta páginaexpand_more

Preparar
Configurar
Formatos
Agente sempre ativo
Verificar
Solução de problemas
Perguntas frequentes

Obtenha uma chave de API e a base URLlink

Todos os clientes usam a mesma chave de API da Wokey e a mesma base URL.

Crie uma chave de API

Entre e crie uma chave da plataforma na página API. As chaves de uma mesma conta compartilham o saldo dela.

Criar chave de APIkey

Use a base URL da Wokey

Defina como base URL do cliente o domínio do gateway; a configuração abaixo mostra se é preciso acrescentar /v1.

Configure o clientelink

O Hermes Agent só precisa das cinco primeiras linhas de configuração: modelo, provider personalizado, Base URL e chave de API. Para modelos GPT (como gpt-6-sol), adicione api_mode: codex_responses para a melhor taxa de acerto de cache; deixe de fora para outros modelos, como o 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
  # Somente modelos GPT (como gpt-6-sol): descomente para a melhor taxa de acerto de cache:
  # api_mode: codex_responses

Formatos de API e base URLslink

Quando um mesmo cliente troca de formato de API, pode mudar se a base URL termina em /v1.

Formato	Base URL	Use para
OpenAI Chat Completions	https://api.wokey.ai	DeepSeek, GLM, Kimi e outros modelos

Onde é configurado: ~/.hermes/config.yaml

Rode o Hermes Agent como agente sempre ativo com o Opus 5.5: comparação com o Claude Duetlink

Em 2026-10-21 a Anthropic abriu uma prévia de pesquisa do Claude Duet, um agente proativo baseado no Claude Opus 5.5 que envia um resumo toda manhã, acompanha em segundo plano os apps que você conectou e pergunta antes de agir. O Duet só funciona com login em uma conta Claude; não há chave de API nem base URL personalizada, então ele não pode rodar pela Wokey. O Hermes Agent é um agente sempre ativo, de código aberto e auto-hospedado: conectado à Wokey, ele usa o mesmo modelo Opus 5.5, sem lista de espera e sem restrição de região.

	Claude Duet	Hermes Agent + Wokey
Modelo	Claude Opus 5.5, não pode ser trocado	claude-opus-5-5 ou qualquer outro modelo da Wokey
Quem pode usar	Assinantes do Claude Pro e Max nos EUA, por lista de espera; ainda não Team nem Enterprise	Você mesmo instala; basta uma chave de API da Wokey, em qualquer região
Custo	Sem cobrança extra durante a prévia, mas compartilha os limites de uso do seu plano com o chat e o Claude Code, incluindo as verificações em segundo plano	Pagamento por token a partir do seu saldo na Wokey; você escolhe com que frequência ele verifica
Onde roda	Uma máquina virtual com navegador próprio na nuvem da Anthropic; continua funcionando com seu celular e notebook desligados	Seu próprio computador ou servidor; hospede em uma máquina sempre ligada para funcionar 24 horas por dia
Como você conversa com ele	O app Duet (iOS e Android) e claude.ai	Apps de chat como Telegram e Slack
Memória e ferramentas	Herda a memória, as skills e os conectores da sua conta Claude	Memória, skills e ferramentas ficam na sua máquina; você instala e gerencia
Aprovação antes de agir	Pergunta antes de enviar mensagens, pagar, assinar ou excluir; negociação de valores mobiliários e transferências entre contas nunca são permitidas	Você define as permissões e as regras de aprovação; dê acesso só às contas necessárias

Com cobrança por token, verificações frequentes custam mais: cada verificação reenvia o prompt de sistema e a memória. Use um modelo mais barato (como claude-sonnet-5-5 ou deepseek-v4.1-flash) nas verificações de rotina e mude para o Opus 5.5 para decisões e ações.
Pelo Chat Completions, o Opus 5.5 pensa antes de escrever, então o primeiro token demora; um agente trabalhando em segundo plano quase não percebe.
A configuração acima já usa claude-opus-5-5 por padrão; não é preciso mudar nada.

Informações do Duet verificadas em 2026-10-22 · Fontes sobre o Duet: Introducing Claude Duet · Claude Duet FAQ

Verifique com curllink

Se o cliente mostrar um erro, primeiro descarte problemas com a chave e a base URL usando curl.

Hermes Agent usa o formato OpenAI Chat Completions por padrão. Se esta requisição retornar 200, a chave e a base URL estão corretas. Substitua YOUR_API_KEY pela sua chave antes de enviar.

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" }
    ]
  }'

Erros e solução de problemaslink

Primeiro separe os casos de autenticação, saldo, limite de taxa, disponibilidade do modelo e tempo limite do upstream.

401

invalid api key

A chave está ausente, foi digitada errado, foi excluída, ou os cabeçalhos Authorization / x-api-key são conflitantes.

402

insufficient balance

O saldo da conta está baixo demais. Recarregue antes de enviar mais requisições.

403

model_denylisted / account_restricted

As chamadas ao modelo, ou a todos os modelos da conta, estão pausadas após violações repetidas. Veja Taxas de tratamento de violação e restrições.

403

request_blocked

Esta requisição foi bloqueada antes de chegar ao upstream e não é cobrada, por exemplo o reenvio sem alterações de uma requisição que o modelo acabou de recusar, ou um usuário final pausado (X-End-User-Id). A mensagem de erro diz o que está bloqueado; altere a requisição conforme indicado ou tente de novo mais tarde. As outras requisições não são afetadas.

429

rate limited

O tráfego está frequente demais. Tente de novo mais tarde ou reduza a concorrência. Se só um modelo, ou um usuário final (X-End-User-Id), continua retornando 429, pode ser um limite temporário após violações.

499

client disconnected

O cliente fechou a conexão antes de a resposta terminar (código downstream_aborted). Por padrão isso é gratuito. Quando uma conta tem pelo menos 50 desconexões do cliente nas últimas 24 horas e elas representam 10% ou mais das suas requisições, as requisições desconectadas seguintes são cobradas pelo uso que o upstream informou: a entrada processada, incluindo leituras e gravações de cache, e a saída apenas quando o upstream a contabilizou. Uma desconexão antes de o upstream informar qualquer uso continua gratuita. A conta é avisada quando a cobrança começa, e a cobrança para automaticamente em até uma hora quando a taxa de desconexão volta ao normal. A causa comum é um tempo limite do cliente ou do proxy curto demais, ou um programa que cancela requisições antes de terminarem.

502

upstream unavailable

O serviço do modelo upstream está temporariamente indisponível. Troque de modelo ou tente de novo mais tarde.

504

upstream timeout

A resposta do upstream excedeu o tempo limite. Encurte o contexto, reduza max_tokens ou tente de novo.

529

upstream overloaded

O modelo upstream está temporariamente sobrecarregado e a Wokey já tentou de novo por outras rotas (código upstream_overloaded). Não tem relação com o seu saldo. Tente de novo em instantes ou troque de modelo.

Perguntas frequenteslink

O base_url do Hermes Agent deve terminar em /v1?: Não. Defina base_url como https://api.wokey.ai e provider como custom.
Quando adiciono api_mode: codex_responses?: Apenas com modelos GPT como gpt-6-sol, em que ele dá a melhor taxa de acerto de cache. Deixe de fora para Claude e outros modelos.
Onde fica a chave de API?: No campo api_key em model no ~/.hermes/config.yaml, apenas a chave.