> ## 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易](/zh-Hant/scenarios/agent/hermes-agent)
* [如何選擇合適的 AI 模型？](/zh-Hant/faq/model-selection-guide)
* [為什麼有些模型我用不了？](/zh-Hant/faq/model-availability)
* [如何檢視我的呼叫記錄？](/zh-Hant/faq/call-logs)

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.