---
title: "OpenAI兼容API"
type: concept
tags: []
last_updated: 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 验证命令：
  ```bash
  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