Hermes

Hermes 类客户端可能支持 OpenAI、Anthropic 或自定义 Provider。接入前先确认它当前使用哪种协议。

统一接入信息

• 平台名称：FreeDom API
• 控制台 / API Base URL：https://api.yonghu.shop
• 鉴权方式：API Key
• API Key 获取：登录控制台 → 令牌 / API Key 页面创建

一、适用场景

• 想把 Hermes 的模型请求接到 FreeDom API
• 已经有平台 API Key
• 需要统一使用平台里的 Claude、GPT、Gemini 或图像模型

二、安装 / 准备

安装 Hermes 客户端，并进入模型/Provider 设置。

三、配置接入

如果是 OpenAI Compatible：

OPENAI_API_KEY=你的_API_Key
OPENAI_BASE_URL=https://api.yonghu.shop

如果是 Anthropic Compatible：

ANTHROPIC_AUTH_TOKEN=你的_API_Key
ANTHROPIC_BASE_URL=https://api.yonghu.shop

模型名填写平台控制台展示的真实名称。

四、启动验证

保存设置后重启客户端，发送最小测试消息。

五、推荐模型填写方式

优先使用控制台里真实展示的模型名。常见可尝试：

• Claude：claude-sonnet-4-5-20250929、claude-opus-4-8、claude-opus-4-8-thinking
• Gemini：gemini-2.5-pro、gemini-2.5-flash
• OpenAI 兼容工具：按平台模型广场/控制台展示为准

六、常见问题

401 Unauthorized

API Key 错误、没保存成功，或请求头没有带上密钥。

403 Forbidden

通常是余额不足、Key 没有权限、模型未开放，或服务返回拒绝。

404 Model Not Found

模型名写错，或者当前 Key 没有这个模型权限。

429 Too Many Requests

请求过快或服务繁忙。降低并发、稍后重试，或切换模型或稍后重试。

七、实用建议

遇到报错时，先判断是 OpenAI 协议报错还是 Anthropic 协议报错，不要混用变量名。

配置前检查

配置客户端前，先确认平台在线：

curl https://api.yonghu.shop/api/status

看到 success: true 或 HTTP 200，说明平台主入口正常。

如果客户端配置失败，优先按这个顺序排查：

1. API Key 是否复制完整，没有多余空格。
2. Base URL 是否该带 /v1。
3. 模型名是否与平台模型广场完全一致。
4. 当前 API Key 是否有该模型权限。
5. 余额是否充足。

成功后建议到 FreeDom API 控制台查看日志，确认请求确实打到了平台。

Hermes 成功判据

Hermes 若支持 OpenAI Compatible Provider，按以下字段填写：

Provider: OpenAI Compatible / Custom OpenAI
Base URL: https://api.yonghu.shop
API Key: 你的 FreeDom API Key
Model: 平台模型名

失败时优先切换 https://api.yonghu.shop 与 https://api.yonghu.shop/v1。如果提示模型不存在，先换平台模型广场里确认可用的模型。