APIMaster.ai
Documentación APIMaster.ai
Quick startAPIMaster.aiMarketplace

Hermes Desktop con APIMaster.ai

Configure la clave de API compatible con OpenAI y la URL base en Hermes Desktop en Windows o macOS, luego elija un modelo en Configuración.

APIMaster.ai es compatible con OpenAI. Hermes lee dos variables de entorno, luego usted elige el modelo en la interfaz de escritorio.

Configuración rápida

Paso 1 — Obtenga su clave de API

  1. Abra la consola de APIMaster.
  2. Copie su clave de API (generalmente comienza con sk-).
  3. Nunca pegue una clave real en chats o capturas de pantalla; use el marcador de posición your_apimaster_key a continuación.

Paso 2 — Edite el archivo .env

Windows

  1. Presione Win + R, pegue y presione Enter:

    %LOCALAPPDATA%\hermes

  2. Abra .env en el Bloc de notas (cree el archivo si falta).

  3. Ruta completa típica:

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

macOS

Hermes Desktop comparte ~/.hermes con la CLI (documentación oficial). Coloque las claves en ~/.hermes/.env.

Opción A — Finder (recomendado)

  1. Ir → Ir a la carpeta… (Shift + Command + G).

  2. Pegue:

    ~/.hermes

    (~ = su carpeta de inicio; .hermes está oculto en Finder a menos que use Ir a la carpeta.)

  3. Abra .env en TextEdit (cree si falta).

Opción B — Terminal

open ~/.hermes

Ruta completa

/Users/YourName/.hermes/.env

Paso 3 — Agregue estas líneas

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL debe terminar con /v1 — no https://apimaster.ai solo.
  • Sin espacios alrededor de =, sin comillas a menos que la documentación de Hermes indique lo contrario.
  • Guarde el archivo.

Paso 4 — Reinicie Hermes Desktop

Cierre completamente Hermes (incluido el icono de la bandeja), luego ábralo nuevamente.

Elija el modelo en la aplicación

  1. Abra Hermes Desktop.

  2. Vaya a Configuración → Modelo → Modelo principal.

  3. Proveedor: Endpoint personalizado.

  4. Modelo: elija un id de modelo compatible, por ejemplo:

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

    Consulte el marketplace o su administrador para obtener la lista completa.

  5. Haga clic en Aplicar, luego cierre Configuración.

Hermes Desktop: Configuración → Modelo → Modelo principal

Prueba: elija un modelo y envíe un mensaje

1. Establezca el modelo principal en Configuración (obligatorio)

  1. Abra Configuración (barra lateral o inferior izquierda).
  2. Vaya a Modelo → Modelo principal.
  3. Proveedor: Endpoint personalizado (o openai-api si aparece).
  4. Abra el menú desplegable Modelo y haga clic en un id (ej. gpt-5.4) — no escriba un nombre para mostrar.
  5. Haga clic en Aplicar y cierre Configuración.

Los chats nuevos usan este modelo después de Aplicar; los chats antiguos aún pueden usar el anterior.

2. Inicie un nuevo chat

  1. Vuelva a la lista de chats.
  2. Haga clic en Nuevo chat (o +).
  3. Use una sesión nueva, no un hilo antiguo.

3. Verifique el modelo activo (recomendado)

Cerca de la entrada puede ver algo como openai-api / gpt-5.4. Si es incorrecto, corrija el Modelo principal, Aplique y abra otro nuevo chat. Algunas versiones también ofrecen un pequeño menú desplegable de modelos junto al compositor.

4. Envíe un mensaje de prueba

Escriba Hello, reply with ok y presione Enter. Una respuesta normal significa que la Clave, la URL base y el modelo están funcionando.

5. ¿Sigue fallando?

Verifique el texto del error (401, 404, tiempo de espera), confirme que Hermes se reinició después de editar .env, o ejecute la prueba de conectividad de API con la misma clave.

Preguntas frecuentes

Problema Qué verificar
El envío falla La URL es https://apimaster.ai/v1; clave copiada completamente; id de modelo exacto; Hermes reiniciado después de editar .env
Falta la carpeta Use ~/.hermes en Mac (no Application Support); inicie Hermes una vez o mkdir -p ~/.hermes
Sin Endpoint personalizado Actualice Hermes a la última versión
Modelos incorrectos Los IDs provienen de APIMaster; consulte Modelos compatibles

Opcional: prueba de conectividad de API con la misma clave.

Seguridad

  • No comparta claves de API en Slack, correo electrónico o documentos públicos.
  • Use marcadores de posición solo en tickets y capturas de pantalla.
  • Si se filtran, revoque la clave en la consola, actualice .env y reinicie Hermes.

Lista de verificación

  • Clave de API copiada de la consola (mantenida privada)
  • OPENAI_API_KEY configurada en .env
  • OPENAI_BASE_URL=https://apimaster.ai/v1 (con /v1)
  • .env guardado
  • Hermes reiniciado completamente
  • Proveedor = Endpoint personalizado, id de modelo seleccionado, Aplicar presionado
  • Mensaje de prueba funciona en una sesión nueva

Ver también