Hermes Agent

Rode o Hermes Agent pela opção de endpoint personalizado compatível com a OpenAI.

Hermes Agent, da Nous Research

O que funciona

O Hermes usa a OneProvider por um provedor personalizado, no modo Chat Completions, com um ID de modelo compatível que você escolhe no catálogo.

Limitação do cliente

Mantenha o API mode em Chat Completions; os outros modos de provedor do Hermes não usam esta conexão compatível com a OpenAI.

Configuração

1. Abra a configuração de modelo do Hermes

   Execute o assistente de modelos e escolha Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. Informe a conexão da OneProvider

   Use https://api.oneprovider.dev/v1, a sua chave dedicada da OneProvider, um ID de modelo compatível que você escolher no catálogo e Chat Completions como API mode.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. Ou configure o Hermes manualmente

   Guarde ONEPROVIDER_API_KEY=… em ~/.hermes/.env e depois defina o bloco model em ~/.hermes/config.yaml.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

Verificar a conexão

Inicie uma nova sessão do Hermes

Faça uma pergunta curta e confirme no Dashboard da OneProvider o ID do modelo configurado, o consumo de tokens e o valor debitado.

Dados da conexão

Protocolo

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Segurança da chave

Use uma chave de inferência dedicada, limitada ao modelo necessário, com controles de requisições, de gastos e de validade. Guarde a chave em ~/.hermes/.env, não no config.yaml.

Qual modelo escolher

Defina default no bloco model do config.yaml. gpt-6.1-terra é um bom padrão do dia a dia, gpt-6.1-sol é o nível de ponta para tarefas difíceis e gpt-5.6-luna é barato para trabalho rápido ou de alto volume. Use Chat Completions como API mode e copie os IDs da página de modelos .

Erros comuns e soluções

401

A chave não está sendo lida: confira se ONEPROVIDER_API_KEY=… está em ~/.hermes/.env e se key_env no config.yaml indica a mesma variável.

404

base_url deve ser https://api.oneprovider.dev/v1 com /v1.

“Model not found”

O ID não está no catálogo ou tem um erro de digitação. Copie-o da página de modelos.

429 “Insufficient balance”

O saldo ou o limite da chave acabou. Recarregue o saldo do painel.

O assistente não lista a OneProvider

Escolha Custom endpoint em hermes model: a OneProvider entra como um endpoint personalizado compatível com a OpenAI.

Perguntas frequentes

Onde guardo a chave?

Em ~/.hermes/.env, não no config.yaml.

Posso usar modelos Claude?

Pode, informe um ID Claude como claude-sonnet-5-5 no mesmo endpoint personalizado; os recursos dependem do modelo.

Como confiro se funciona?

Inicie uma nova sessão, faça uma pergunta curta e procure a requisição em Consumo no Dashboard.

Respostas rápidas

Qual base URL devo usar?

O Claude Code e os SDKs da Anthropic usam https://api.oneprovider.dev. Os SDKs da OpenAI e os clientes compatíveis com a OpenAI usam https://api.oneprovider.dev/v1. Uma única chave funciona nos dois; a lista de modelos está na página de modelos e os preços, na página de preços .

Como me autentico?

Envie a chave sk-… pura em x-api-key ou em Authorization: Bearer: um dos dois, nunca ambos. Guarde a chave em uma variável de ambiente, não em um arquivo que vai para o commit. Mais sobre autenticação .

Onde consigo uma chave?

Abra o seu painel no bot do Telegram @oneprovider_robot ou em app.oneprovider.dev, recarregue o saldo e toque em “Emitir chave”. Cada chave pode ter o seu próprio limite de gastos. Painel e chaves de API .

O que significam 401, 404 e 429?

401: a chave está ausente, foi digitada errado ou enviada no cabeçalho errado; cole a chave inteira, sem aspas nem espaços. 404: em geral, uma base URL errada, por exemplo um /v1 ausente ou duplicado. 429 com “Insufficient balance”: o saldo do painel ou o limite de gastos da chave acabou, então recarregue em vez de tentar de novo; qualquer outro 429 é um limite de requisições, então aguarde o tempo de Retry-After. Detalhes: códigos de erro e solução de problemas .

Por que os streams são cortados ou reiniciados?

VPNs e proxies VLESS costumam armazenar SSE em buffer ou quebrar a negociação do HTTP/2. A OneProvider não tem restrições regionais e não armazena streams em buffer; desative o proxy e tente de novo.

Onde pergunto se isso não bastar?

Escreva para @Oneproviderhelpbot no Telegram ou abra “Suporte” no painel web, informando o código de status HTTP e a mensagem de erro exata. Como funciona o suporte .