It looks like you may prefer a different language. Switch anytime.

HERMES AGENT 指南

在 Hermes Agent 使用 RunAPI。

Hermes Agent 可以將自訂的 OpenAI 相容 endpoint 用於聊天模型。把提示詞複製到 Hermes Agent,讓它建立自訂 provider,只有在你需要精確 YAML 時才使用 config 分頁。

複製提示詞 · 一組 RunAPI 金鑰 · Hermes CLI 工作流程
Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.5.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.
custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.5
export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes
Copy prompt first /v1
SETUP

用提示詞在 Hermes Agent 中安裝 RunAPI

1

貼上設定提示詞

把第一個分頁中的提示詞複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY,並將 RunAPI 新增為具名的自訂 provider。

Copy prompt
2

檢查產生的設定

Hermes Agent 應將 provider 設為 custom:runapi,預設為 gpt-5.2,並將 key_env 指向 RUNAPI_API_KEY。

provider: custom:runapi
3

執行診斷

編輯設定後先執行 hermes doctor,然後開啟 Hermes Agent 並送出一段簡短測試提示詞,再用於較大型的任務。

hermes doctor
REFERENCE

設定欄位

欄位 用途
custom_providers.name runapi 建立一個具名的自訂 endpoint,讓 Hermes Agent 可選為 custom:runapi。
base_url https://runapi.ai/v1 將 Hermes Agent 指向 RunAPI 的 OpenAI 相容 API 介面。
key_env RUNAPI_API_KEY 從環境變數讀取 RunAPI 金鑰,而不是硬編碼。
api_mode chat_completions 使用 OpenAI 相容的聊天請求格式。
不只大型語言模型

單一端點,圖像、影片、音樂全支援。

Hermes Agent 使用者通常需要架設每月約 $20 的 ComfyUI 雲端實例來處理圖像和影片,或另外建置音樂橋接服務。RunAPI 取代了這一切——同一個 custom:runapi provider 和 RUNAPI_API_KEY,聊天、圖像、影片、音樂請求一次搞定,無需額外外掛或 GPU 租用。

圖像生成

透過 RunAPI endpoint 呼叫 Flux Kontext、Imagen 4、Seedream、GPT Image 和 Nano Banana。無需 ComfyUI 設定、無需雲端 GPU、無需工作流圖——傳送提示詞,接收圖像 URL。

瀏覽圖像模型

影片生成

使用 Kling 3.0、Seedance 2.0、Veo 3 和 Wan 2.7 從文字或圖像生成影片。RunAPI 以統一的任務格式處理所有影片模型的非同步輪詢和回呼。

瀏覽影片模型

音樂生成

直接透過 RunAPI 存取 Suno v4 到 v5.5。無需第三方橋接服務——傳入歌詞、風格和時長,然後輪詢已完成的音訊。

瀏覽音樂模型
模型指南

在 Hermes Agent 中使用任何模型

每份指南都包含在 Hermes Agent 中透過 RunAPI 呼叫特定模型所需的提示詞、curl 指令、參數說明與常見問題。

FAQ

Hermes Agent 設定常見問題

在 Hermes Agent 內使用一組 RunAPI 金鑰。

從目錄中挑選模型,設定自訂 endpoint,並在下一次 agent 執行前先驗證 Hermes Agent。