nexus/wiki/concepts/OpenAI兼容API.md

title, type, tags, last_updated

title	type	tags	last_updated
OpenAI兼容API	concept		2026-05-02

Definition

Hermes Agent 内置的 API Server 暴露的标准 OpenAI Chat Completions 接口格式，允许任何兼容 OpenAI API 的客户端（如 n8n、curl、Postman）直接调用，无需额外 SDK 或中间件。

Details

• 默认端口 8642，端点路径 /v1/chat/completions
• 认证方式：Bearer Token（通过 API_SERVER_KEY 配置）
• 健康检查端点：GET /v1/health，返回 {"status": "ok"}
• 支持 X-Hermes-Session-Id header 实现会话保持（v0.7.0+）
• 模型名称默认为 hermes-agent，可在 Profile 级别自定义

Usage

• n8n 的 HTTP Request 节点通过 POST 到该端点实现 Agent 调用
• curl 验证命令：

  curl http://localhost:8642/v1/chat/completions \
    -H "Authorization: Bearer YOUR_KEY" \
    -H "Content-Type: application/json" \
    -d '{"model": "hermes-agent", "messages": [{"role": "user", "content": "Hello!"}]}'
  

Related

• HermesAgent — API Server 的宿主框架
• X-Hermes-Session-Id — API 的会话保持机制
• 工作流编排 — 该 API 的主要应用场景

Aliases

• OpenAI Compatible API
• OpenAI-compatible API endpoint
• Hermes API Server