全部產品
Search
文件中心

Alibaba Cloud Model Studio:Hermes Agent

更新時間:Nov 16, 2026

在 Hermes Agent 中使用阿里雲百鍊模型。

快速接入

選擇您使用的用戶端,完成設定。

CLI

  1. 1

    取得 API Key

  2. 2

    設定模型

    執行 hermes model,依計費方案選擇 provider,輸入 API Key 並選擇模型。

    Token Plan

    1. 選擇 Qwen > Alibaba Cloud (Token Plan)。
    2. 輸入 Token Plan API Key,Base URL 保持預設。
    3. 選擇模型。支援的模型請參閱個人版支援的模型和團隊版支援的模型。

    按量計費

    1. 選擇 Qwen > Qwen Cloud (Alibaba DashScope)。
    2. 輸入百煉 API Key。
    3. 以下以新加坡為例,Base URL 填寫 https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1,將 {WorkspaceId} 替換為實際的 Workspace ID。
    4. 選擇模型。支援的模型請參閱支援的模型。

    Coding Plan

    1. 選擇 Qwen > Alibaba Cloud (Coding Plan)。
    2. 輸入 Coding Plan 專屬 API Key,Base URL 保持預設。
    3. 選擇模型。支援的模型請參閱 Coding Plan 支援的模型。

    說明provider 列表中的模型可能多於目前方案支援的模型,實際可用模型以方案支援清單為準。

  3. 3

    驗證

    執行以下命令驗證:

    hermes chat -q "你好"
    

桌面版

  1. 1

    設定模型

    請依照透過設定檔接入寫入對應方案的設定,或先在 CLI 中完成設定。

  2. 2

    選擇模型

    開啟 Hermes Desktop,進入 Settings → Model,選擇同名 provider 和模型。

透過設定檔接入

自 v2026.8.31 起,hermes model 的 provider 清單包含阿里雲百鍊。若清單中沒有,請按照以下步驟接入。

  1. 1

    開啟或新建設定檔

    • macOS / Linux / WSL2:~/.hermes/config.yaml
    • Windows:%LOCALAPPDATA%\hermes\config.yaml
  2. 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_KEY
    

    Anthropic 相容協定

    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_KEY
    

    Anthropic 相容協定

    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_KEY
    

    Coding Plan

    OpenAI 相容協定

    model:
      default: qwen3.7-plus
      provider: custom
      base_url: https://coding-intl.dashscope.aliyuncs.com/v1
      api_key: YOUR_API_KEY
    

    Anthropic 相容協定

    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. 3

    驗證

    儲存後執行 hermes chat -q "你好" 進行驗證。

錯誤碼

設定過程中遇到錯誤時,請參考對應計費方案的常見問題文件:

常見問題

hermes model 中沒有阿里雲百煉

透過設定檔接入。

模型不可用

hermes model 的模型清單可能包含目前方案不支援的模型。請依對應方案的支援清單選擇,或選擇 Enter custom model name 後輸入模型 ID。

節省計劃如何接入

節省計劃的接入方式同按量計費,會自動抵扣符合條件的呼叫費用。抵扣規則見節省計劃。