APIMaster.ai
Documentação APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop com APIMaster.ai

Configure a chave de API e a URL base compatível com OpenAI no Hermes Desktop no Windows ou macOS e escolha um modelo nas Configurações.

APIMaster.ai é compatível com OpenAI. O Hermes lê duas variáveis de ambiente e, em seguida, você escolhe o modelo na interface desktop.

Configuração rápida

Passo 1 — Obtenha sua chave de API

  1. Abra o console APIMaster.
  2. Copie sua Chave de API (geralmente começa com sk-).
  3. Nunca cole uma chave real em chats ou capturas de tela; use o placeholder sua_chave_apimaster abaixo.

Passo 2 — Edite o arquivo .env

Windows

  1. Pressione Win + R, cole e pressione Enter:

    %LOCALAPPDATA%\hermes

  2. Abra .env no Bloco de Notas (crie o arquivo se não existir).

  3. Caminho completo típico:

    C:\Users\SeuNome\AppData\Local\hermes\.env

macOS

O Hermes Desktop compartilha ~/.hermes com a CLI (documentação oficial). Coloque as chaves em ~/.hermes/.env.

Opção A — Finder (recomendado)

  1. Ir → Ir para a Pasta… (Shift + Command + G).

  2. Cole:

    ~/.hermes

    (~ = sua pasta pessoal; .hermes fica oculto no Finder, a menos que use Ir para a Pasta.)

  3. Abra .env no TextEdit (crie se não existir).

Opção B — Terminal

open ~/.hermes

Caminho completo

/Users/SeuNome/.hermes/.env

Passo 3 — Adicione estas linhas

OPENAI_API_KEY=sua_chave_apimaster
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL deve terminar com /v1 — não apenas https://apimaster.ai.
  • Sem espaços ao redor de =, sem aspas, a menos que a documentação do Hermes diga o contrário.
  • Salve o arquivo.

Passo 4 — Reinicie o Hermes Desktop

Feche completamente o Hermes (incluindo o ícone da bandeja) e abra-o novamente.

Escolha o modelo no aplicativo

  1. Abra o Hermes Desktop.

  2. Vá em Configurações → Modelo → Modelo principal.

  3. Provedor: Endpoint personalizado.

  4. Modelo: escolha um id de modelo compatível, por exemplo:

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    Consulte o marketplace ou seu administrador para a lista completa.

  5. Clique em Aplicar e feche as Configurações.

Hermes Desktop: Configurações → Modelo → Modelo principal

Teste: escolha um modelo e envie uma mensagem

1. Defina o modelo principal nas Configurações (obrigatório)

  1. Abra Configurações (barra lateral ou canto inferior esquerdo).
  2. Vá em Modelo → Modelo principal.
  3. Provedor: Endpoint personalizado (ou openai-api, se exibido).
  4. Abra o menu suspenso Modelo e clique em um id (ex.: gpt-5.4) — não digite um nome de exibição.
  5. Clique em Aplicar e feche as Configurações.

Novos chats usam este modelo após Aplicar; chats antigos podem continuar usando o anterior.

2. Inicie um novo chat

  1. Volte para a lista de chats.
  2. Clique em Novo chat (ou +).
  3. Use uma sessão nova, não um tópico antigo.

3. Verifique o modelo ativo (recomendado)

Perto da entrada de texto, você pode ver algo como openai-api / gpt-5.4. Se estiver errado, corrija o Modelo principal, Aplique e abra outro novo chat. Algumas versões também oferecem um pequeno menu suspenso de modelo ao lado do compositor.

4. Envie uma mensagem de teste

Digite Olá, responda com ok e pressione Enter. Uma resposta normal significa que a Chave, URL base e modelo estão funcionando.

5. Ainda com problemas?

Verifique o texto do erro (401, 404, timeout), confirme se o Hermes foi reiniciado após editar o .env ou execute o teste de conectividade da API com a mesma chave.

Perguntas frequentes

Problema O que verificar
O envio falha URL é https://apimaster.ai/v1; chave copiada por completo; id do modelo exato; Hermes reiniciado após editar .env
Pasta ausente Use ~/.hermes no Mac (não Application Support); inicie o Hermes uma vez ou mkdir -p ~/.hermes
Sem Endpoint personalizado Atualize o Hermes para a versão mais recente
Modelos errados Os IDs vêm do APIMaster; veja Modelos compatíveis

Opcional: teste de conectividade da API com a mesma chave.

Segurança

  • Não compartilhe chaves de API no Slack, e-mail ou documentos públicos.
  • Use placeholders apenas em tickets e capturas de tela.
  • Se vazar, revogue a chave no console, atualize o .env e reinicie o Hermes.

Lista de verificação

  • Chave de API copiada do console (mantida em sigilo)
  • OPENAI_API_KEY definida no .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (com /v1)
  • .env salvo
  • Hermes completamente reiniciado
  • Provedor = Endpoint personalizado, id do modelo selecionado, Aplicar clicado
  • Mensagem de teste funciona em uma sessão nova

Veja também