Seedream 5.0 Pro 正式上線 | 在圖片生成器中體驗 →
登入
儀表板探索AI 生成器熱門桌面應用API 金鑰儲值
Agent 設定

將 Hermes 接入 WaveSpeed LLM API

複製推薦的 ~/.hermes/config.yaml 設定，將 Hermes 請求路由到 /v1/chat/completions，並在 WaveSpeed Logs 中驗證本機 agent 呼叫。

API Key測試模型
設定檔

~/.hermes/config.yaml

協定

OpenAI 相容 Chat Completions

Endpoint

/v1/chat/completions

快速開始

1

建立 WaveSpeed Access Key

2

在本機匯出所需金鑰

3

將設定貼到~/.hermes/config.yaml

4

執行 hermes chat 並查看 Logs

OpenAI 相容 Chat Completions

用量會顯示在 Dashboard 和 Logs 中

不用改 Agent 程式碼即可切換模型

編輯 ~/.hermes/config.yaml
# File: ~/.hermes/config.yaml
model:
  default: "deepseek/deepseek-v4-flash"
  provider: wavespeed
custom_providers:
  - name: wavespeed
    base_url: https://llm.wavespeed.ai/v1
    key_env: WAVESPEED_API_KEY
    api_mode: chat_completions

不要替換變數名稱

WAVESPEED_API_KEY 是 Agent 讀取的環境變數名稱。設定檔中請保持這個名稱不變，真實 API key 放到你的 shell 環境變數中。

1

僅目前終端機生效

關閉這個終端機視窗後會失效，適合臨時測試。

export WAVESPEED_API_KEY="wsk_live_..."
2

重啟後仍然生效

寫入 shell 設定檔，之後新開的終端機也能讀取。

echo 'export WAVESPEED_API_KEY="wsk_live_..."' >> ~/.zshrc
source ~/.zshrc

Agent 接入指南

將 Hermes 接入 WaveSpeed LLM API

本指南說明如何透過 ~/.hermes/config.yaml、OpenAI 相容 Chat Completions、/v1/chat/completions、base URL https://llm.wavespeed.ai/v1 和預設模型 deepseek/deepseek-v4-flash 將 Hermes 接入 WaveSpeed AI。複製上方設定，匯出 API key，執行 agent，然後在 Logs 中驗證請求。

1

建立 WaveSpeed Access Key

2

在本機匯出所需金鑰

3

將設定貼到

~/.hermes/config.yaml
4

執行 hermes chat 並查看 Logs

這個 Hermes 設定會配置什麼

協定

OpenAI 相容 Chat Completions

Endpoint

/v1/chat/completions

模型

deepseek/deepseek-v4-flash

上方可複製設定就是推薦方案下唯一需要編輯的 Hermes 檔案：~/.hermes/config.yaml。API key 建議保留在 shell 環境變數中，避免提交到程式碼倉庫。

常見問題排查

API key 沒有生效

請在運行 Hermes 的同一個 shell 中導出 WAVESPEED_API_KEY。如果寫入 shell profile，需要重新加載終端後再啟動 agent。

請求出現協議或 endpoint 錯誤

確認 Hermes 使用的是 OpenAI 相容 Chat Completions 和 endpoint /v1/chat/completions。協議不匹配是 404 或 payload 錯誤最常見的原因。

選擇的模型不可用

先確認模型 ID 存在於 WaveSpeed Models，再將完整 ID 粘貼到 ~/.hermes/config.yaml。也可以先使用本頁展示的默認模型。

Logs 中沒有請求記錄

確認 Hermes 使用的是 WaveSpeed base URL 和當前 API key。然後從本地 agent 發送一個新 prompt，並刷新 Logs。

這個 Hermes 指南可以被搜尋到嗎？

可以。這個頁面設計成可索引的接入指南，用來承接搜尋 Hermes custom provider、OpenAI-compatible endpoint、base URL 和本機 agent 設定流程的使用者。

查看全部 Agent 接入指南瀏覽模型
將 Hermes 接入 WaveSpeed LLM API