> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 为什么 Hermes 的模型列表只显示部分模型？

> 说明 Hermes 模型选择器每个 Provider 的 50 条上限，以及如何通过完整模型 ID 切换列表之外的模型。

## 简短回答

在本次核对的 Hermes 实现中，模型选择器每个 Provider 最多显示 **50 个模型**。这是传给选择器的数据上限，不是 API Key 的模型权限上限。API 端点或 Hermes 缓存里可以有更多模型 ID；超出列表上限的模型仍可尝试通过完整模型 ID 选择，但是否能成功调用要单独测试。

选择器把 `models` 字段截取为 `model_ids[:max_models]`，而 `total_models` 记录截断前的数量。因此 `50 available` 表示菜单最多显示 50 项，不表示 Provider 总共只有 50 个模型。

Hermes Desktop 与终端选择器在同一后端、Profile、Provider 和模型目录下应使用相同的选择逻辑。因此，如果两边看到的数量不同，50 条上限解释的是“菜单少于完整目录”，但还应确认比较的是同一个 Provider 和同一份目录。

## 先分清三种数量

| 入口 | 表示什么 |
| - | - |
| `/v1/models` 或 `provider_models_cache.json` | API 返回或 Hermes 缓存的模型 ID 数量 |
| Hermes Desktop / `/model` 选择器 | 每个 Provider 最多展示 50 个模型 ID |
| `/model <模型 ID>` | 按完整名称切换当前会话模型，不要求该 ID 出现在前 50 项 |

## 排查步骤

1. **核对 Provider 行**：`openai-api`、`openai` 和 `openrouter` 是不同 Provider 项；上限按 Provider 分别计算。先确认 Desktop 与终端比较的是同一行，而不是把一个 Provider 的可选数与另一个的目录总数相比。
2. **列表里找不到时直接输入模型 ID**：在会话中使用 `/model gpt-5.5`，或用 `hermes chat --model gpt-5.5` 启动。把 `gpt-5.5` 换成 API 端点实际返回的完整模型 ID；如果需要，按 Hermes 支持的 Provider 前缀格式指定 Provider。
3. **设置默认模型并复核**：可用 `hermes config set model.default gemini-3.8-flash` 设置默认模型，然后运行 `hermes config show` 确认值已写到正确字段。`hermes config set` 不会替模型名做可用性验证；拼错后仍要通过真实请求确认。
4. **区分列表上限与模型调用失败**：选择器显示 50 项只能说明菜单截断，不能证明第 51 项以后全部可用。对选中的完整模型 ID 发起最小请求，并在 API易调用日志中检查请求是否到达、状态码和错误信息。

当前没有可在 `config.yaml` 中调整的 50 项上限。若同一 Hermes 版本、Profile、Provider 和缓存下，Desktop 与终端菜单仍返回不同数量，记录两边的 Provider 名、完整模型 ID、Hermes 后端版本和调用日志，再进一步定位。提交日志前请移除 API Key。

## 相关文档

* [Hermes Agent 接入 API易](/scenarios/agent/hermes-agent.md)
* [如何选择合适的 AI 模型？](/faq/model-selection-guide.md)
* [为什么有些模型我用不了？](/faq/model-availability.md)
* [如何查看我的调用记录？](/faq/call-logs.md)

Hermes 官方说明可参考：`hermes-agent.nousresearch.com/docs/user-guide/desktop`、`hermes-agent.nousresearch.com/docs/user-guide/configuring-models`、`hermes-agent.nousresearch.com/docs/reference/model-catalog`。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.