Hermes 接入 CC Switch 教程
ModelGate 专属教程：Hermes 接入 CC Switch
Section titled “ModelGate 专属教程：Hermes 接入 CC Switch”本教程适用于通过 ModelGate 中转站为 Hermes 配置 CC Switch 供应商。请按截图完成 Hermes 专用 API Key 创建、OpenAI Chat Completions 模式选择、模型获取和保存。
Hermes 在本教程中使用 OpenAI Chat Completions 接入方式。请重点核对供应商名称、API 地址、API 模式和 API Key，模型列表以 CC Switch 实际获取结果为准。
需要让 Hermes 通过 ModelGate 调用 OpenAI 兼容模型，并由 CC Switch 保存供应商配置。
创建 Hermes 专用 Key，新增 ModelGate 供应商，选择 OpenAI Chat Completions 模式。
完成标准
CC Switch 成功获取模型列表并保存供应商，Hermes 后续可直接选择该供应商使用。
接口端点 统一填写 https://modelgate.app。API 模式选择 OpenAI Chat Completions。模型列表以当前 CC Switch 获取结果为准。
创建 Hermes Key
Section titled “创建 Hermes Key”进入 ModelGate 后台创建 Hermes 专用 API Key。专用 Key 便于区分 Hermes 用量，也方便单独停用或更换。 注册账号后进入 令牌管理 页面。创建密钥时名称可填写 Hermes，分组选择适合 OpenAI 兼容调用的分组。创建完成后确认 Key 信息和分组无误。在操作区点击 导入 CCS，将该 Key 带入 CC Switch。
添加 Hermes 供应商
Section titled “添加 Hermes 供应商”切换到 CC Switch 顶部的 Hermes 页面，新增 ModelGate 供应商。该页面会把 Hermes 所需的供应商信息集中保存。
- 供应商名称保持 ModelGate，便于后续识别。
- API 地址填写 https://modelgate.app。
- API 模式选择 OpenAI Chat Completions。
- API Key 填入刚创建的 Hermes 专用 Key。
获取模型并保存
Section titled “获取模型并保存”点击获取模型，确认模型列表能够正常返回，再检查 JSON 配置并保存。确认 apiKey 已填入、baseUrl 为 **https://modelgate.app**、API 模式为 Chat Completions。保存后供应商卡片显示完成，即可在 Hermes 中使用该配置。
最终核对清单
Section titled “最终核对清单”- 已创建 Hermes 专用 ModelGate Key。
- CC Switch 已切换到 Hermes 页面，并新增 ModelGate 供应商。
- 供应商 API 地址为 https://modelgate.app，API 模式为 OpenAI Chat Completions。
- API Key 已填入 Hermes 专用 Key。
- 已点击获取模型，并确认模型列表正常返回。
- 供应商已保存完成，Hermes 后续可选择该配置使用。
常见问题排查
Section titled “常见问题排查”Hermes 无法获取模型列表怎么办？
优先检查 API 地址是否为 https://modelgate.app、API 模式是否为 OpenAI Chat Completions，以及 API Key 是否正确。
保存后 Hermes 仍然无法调用怎么办？
回到 CC Switch Hermes 页面，确认供应商卡片处于启用状态。如已启用但仍无法调用，尝试重新获取模型并保存。