Hermes Agent 可以將 RunAPI 用作自訂 endpoint 嗎？

可以。Hermes Agent 支援模型選擇和自訂 endpoint。請將具名的自訂 provider 設定為使用 RunAPI /v1 base URL，將 API key 保留在 RUNAPI_API_KEY，並選擇例如 gpt-5.2 的 RunAPI model。

應該用 hermes model，還是直接編輯 config file？

當你想用引導式選擇器時，請使用 hermes model。當你需要可重複套用到 server 或共享環境的設定時，請編輯 config file。無論哪種方式，之後都應以 hermes doctor 驗證。

Hermes Agent 的 RUNAPI_API_KEY 應該設定在哪裡？

請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動方式不一定會繼承你互動式 shell 的變數。

加入 RunAPI 後，Hermes Agent 還可以使用其他 provider 嗎？

可以。將 RunAPI 加入為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你要在已設定的模型之間切換時，請使用 hermes model 或 /model 指令。

HERMES AGENT 指南

在 Hermes Agent 使用 RunAPI。

Hermes Agent 可使用自訂 OpenAI 相容 endpoint 來處理 chat models。將 prompt 複製到 Hermes Agent，讓它建立自訂 provider；只有當你需要精確的 YAML 時，才用 config 分頁。

取得免費 API Key 閱讀文件

複製 prompt · 一個 RunAPI key · 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

以 prompt 在 Hermes Agent 安裝 RunAPI

貼上設定 prompt

將第一個分頁的 prompt 複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY，並將 RunAPI 加入為具名的自訂 provider。

Copy prompt

檢視生成的 config

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

provider: custom:runapi

執行診斷

編輯 config 後先執行 hermes doctor，然後開啟 Hermes Agent，送出一個簡短測試 prompt，之後再用於較大型任務。

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 key，而不是硬編碼。
`api_mode`	`chat_completions`	使用 OpenAI 相容的 chat request 格式。

不止大語言模型

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

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 以統一的 task 格式處理所有影片模型的非同步輪詢及 callback。

瀏覽影片模型

音樂生成

直接透過 RunAPI 存取 Suno v4 至 v5.5。毋須第三方橋接服務——傳入歌詞、風格及時長，然後輪詢已完成的音訊。

瀏覽音樂模型

模型指南

在 Hermes Agent 中使用任何模型

每份指南都包含 prompt、curl 指令、參數及常見問題，說明如何在 Hermes Agent 內透過 RunAPI 呼叫特定模型。

Hermes Agent 設定常見問題

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

從型錄揀選一個模型，設定自訂 endpoint，並在下一次 agent run 前先驗證 Hermes Agent。

瀏覽模型 →

在 Hermes Agent 使用 RunAPI。

以 prompt 在 Hermes Agent 安裝 RunAPI

貼上設定 prompt

檢視生成的 config

執行診斷

設定欄位

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

圖像生成

影片生成

音樂生成

在 Hermes Agent 中使用任何模型

Claude

DeepSeek

ElevenLabs

Embedding

Fish Audio

Flux

Flux 2

Flux Kontext

Gemini

Gemini Omni

Gemini TTS

GLM

GPT

GPT Image

GPT Image 2

GPT-4o Image

Grok

Grok Imagine

Hailuo

HappyHorse

Ideogram V3

Imagen 4

InfiniteTalk

Kimi

Kling

Luma

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Runway Aleph

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan