在 Hermes Agent 中使用阿里雲百鍊模型。
快速接入
選擇您使用的用戶端,完成設定。
CLI
- 1
取得 API Key
- Token Plan 個人版:建立或查看 API Key
- Token Plan 團隊版:分配席位並取得 API Key
- 按量計費:百煉 API Key
- Coding Plan:Coding Plan API Key
- 2
設定模型
執行
hermes model,依計費方案選擇 provider,輸入 API Key 並選擇模型。Token Plan
按量計費
- 選擇
Qwen>Qwen Cloud (Alibaba DashScope)。 - 輸入百煉 API Key。
- 以下以新加坡為例,Base URL 填寫
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1,將{WorkspaceId}替換為實際的 Workspace ID。 - 選擇模型。支援的模型請參閱支援的模型。
Coding Plan
- 選擇
Qwen>Alibaba Cloud (Coding Plan)。 - 輸入 Coding Plan 專屬 API Key,Base URL 保持預設。
- 選擇模型。支援的模型請參閱 Coding Plan 支援的模型。
說明provider 列表中的模型可能多於目前方案支援的模型,實際可用模型以方案支援清單為準。
- 選擇
- 3
驗證
執行以下命令驗證:
hermes chat -q "你好"
桌面版
- 1
設定模型
請依照透過設定檔接入寫入對應方案的設定,或先在 CLI 中完成設定。
- 2
選擇模型
開啟 Hermes Desktop,進入 Settings → Model,選擇同名 provider 和模型。
透過設定檔接入
自 v2026.8.31 起,hermes model 的 provider 清單包含阿里雲百鍊。若清單中沒有,請按照以下步驟接入。
- 1
開啟或新建設定檔
- macOS / Linux / WSL2:
~/.hermes/config.yaml - Windows:
%LOCALAPPDATA%\hermes\config.yaml
- macOS / Linux / WSL2:
- 2
寫入設定
請將
YOUR_API_KEY替換為對應方案的 API Key;按量計費還需將{WorkspaceId}替換為實際值。請將設定寫入model部分。Token Plan
OpenAI 相容協定
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYAnthropic 相容協定
model: default: auto provider: custom base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEY按量計費
以下範例使用新加坡。
OpenAI 相容協定
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 api_key: YOUR_API_KEYAnthropic 相容協定
model: default: qwen3.8-max provider: custom base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEYCoding Plan
OpenAI 相容協定
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/v1 api_key: YOUR_API_KEYAnthropic 相容協定
model: default: qwen3.7-plus provider: custom base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic api_mode: anthropic_messages api_key: YOUR_API_KEY說明使用 qwen4-max-preview 時,
provider必須保持custom,不要設為anthropic,否則模型名稱會被改寫並回傳 400。說明使用 qwen4-max 時,
provider必須保持custom,不要設為anthropic,否則模型名稱會被改寫並傳回 400。qwen4-max 的上下文長度為 1M Token;非思考模式最大輸出 131,072 Token,思考與最終回答合計最大 262,144 Token;預設 reasoning_effort=high,thinking_budget=131072。 - 3
驗證
儲存後執行
hermes chat -q "你好"進行驗證。
錯誤碼
設定過程中遇到錯誤時,請參考對應計費方案的常見問題文件:
- Token Plan:個人版常見問題 · 團隊版常見問題
- 按量計費:錯誤代碼
- Coding Plan:Coding Plan 常見問題
常見問題
hermes model 中沒有阿里雲百煉
透過設定檔接入。
模型不可用
hermes model 的模型清單可能包含目前方案不支援的模型。請依對應方案的支援清單選擇,或選擇 Enter custom model name 後輸入模型 ID。
節省計劃如何接入