IKUN API

配置核验

Hermes 当前推荐使用 providers.<名称> 定义自定义端点，并用 model.provider: custom:<名称> 选择它。旧版 custom_providers 列表和 model.base_url/api_mode 仍兼容，但不是本文主配置格式。

1. 准备 API Key、模型和接口类型

1
在 API Key 页面创建密钥。
2
在模型定价页面复制准确的模型 ID。
3
根据模型实际接口选择 Hermes transport 和 Base URL。

模型接口	Hermes transport	Base URL
`/v1/chat/completions`	`chat_completions`	`https://ikun.love/v1`
`/v1/responses`	`codex_responses`	`https://ikun.love/v1`
`/v1/messages`	`anthropic_messages`	`https://ikun.love`

2. 推荐：使用 hermes model 向导

在 Hermes 会话外的系统终端运行完整服务商配置向导：

终端

hermes model

1
选择 Custom endpoint。
2
输入与接口匹配的 Base URL。
3
输入 API Key 和准确模型 ID。
4
选择 API compatibility mode：Chat Completions 使用 chat_completions，Responses 使用 codex_responses，Anthropic Messages 使用 anthropic_messages。
5
保存并退出向导。

向导与会话命令的区别

hermes model 是完整的服务商配置向导；会话内的 /model 只能切换已经配置好的服务商，不能新增端点或录入密钥。

3. 在 config.yaml 中直接保存密钥

将 API Key 直接写入用户级 ~/.hermes/config.yaml（Windows 对应 %USERPROFILE%\.hermes\config.yaml）。关闭终端后，Hermes 仍会从该配置文件读取密钥。配置文件包含明文密钥，请限制访问权限，不要提交到 Git。

以下示例按 Chat Completions 编写。Responses 模型请把 transport 改为 codex_responses；Anthropic Messages 模型还要把 api 改为不带 /v1 的服务根地址。

~/.hermes/config.yaml

providers:
  alltokenapi:
    api: https://ikun.love/v1
    api_key: "此处替换为 API Key"
    transport: chat_completions
    default_model: 此处替换为准确的模型 ID

model:
  provider: custom:alltokenapi
  default: 此处替换为准确的模型 ID

将配置合并到现有 config.yaml，不要覆盖终端、工具、Gateway 或其他服务商设置。

如果希望端点不请求 /models，可在服务商配置中增加：

config.yaml

providers:
  alltokenapi:
    discover_models: false

4. 验证配置

先确认当前配置文件路径，再检查服务商与最终模型路由。

配置检查

hermes config path
hermes config check
hermes config get providers.alltokenapi --json
hermes config get model --json
hermes status

最后执行一次最小请求，并到使用日志确认实际模型、接口和请求状态。

最小请求

hermes -z "只回复 OK"

5. 配置何时生效

新启动的 CLI 会话会读取新配置。
已经运行的会话继续使用创建时的模型；会话内可用 /model 切换已配置服务商。
Messaging Gateway 的新会话读取新默认模型。

需要强制所有会话重新读取时，运行：

终端

hermes gateway restart

6. 常见问题

404 或接口路径错误

chat_completions 和 codex_responses 的 api 通常以 /v1 结尾。
anthropic_messages 使用服务根地址，由 Hermes 拼接 /v1/messages。
transport 留空时 Hermes 会尝试按 URL 自动判断，但中转地址通常无法可靠反映协议，建议显式设置。

Hermes 仍使用旧服务商

model.provider 必须为 custom:alltokenapi，不是 alltokenapi 或 custom。
model.default 与 providers.alltokenapi.default_model 应使用相同的准确模型 ID。
已运行会话不会自动切换，启动新会话或使用 /model。

认证失败

检查 providers.alltokenapi.api_key 是否已填写有效密钥。
如果 Hermes 以服务方式运行，重启 Gateway 以重新载入配置文件。

普通对话成功但 Agent 工具调用失败

确认模型支持 Tool Calling。
确认 transport 与模型实际接口一致。
Responses 接口必须使用 codex_responses，不能用 chat_completions 侥幸兼容。

Hermes Agent