在 Hermes Agent 使用 RunAPI。
Hermes Agent 可使用自訂 OpenAI 相容 endpoint 來處理 chat models。將 prompt 複製到 Hermes Agent，讓它建立自訂 provider；只有當你需要精確的 YAML 時，才用 config 分頁。
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.5export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes以 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
設定欄位
| 欄位 | 值 | 用途 |
|---|---|---|
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 租用。
在 Hermes Agent 中使用任何模型
每份指南都包含 prompt、curl 指令、參數及常見問題，說明如何在 Hermes Agent 內透過 RunAPI 呼叫特定模型。
InfiniteTalk
從音訊生成對嘴說話虛擬人物影片
Grok Imagine
xAI 圖像與影片生成
Flux Kontext
文字引導圖像編輯
Z Image
快速雙語圖像生成
Topaz
AI 圖像與影片放大
Imagen 4
Google 圖像生成
Seedream
Bytedance 4K 圖像生成
Qwen 2 Image
阿里巴巴圖像生成與編輯
Kling
帶動作控制和音訊的影片生成
Veo 3
Google 電影級影片，含原生音訊
Seedance
Bytedance 平價影片生成
Hailuo
MiniMax 影片，每日免費配額
Wan
開源影片與圖像生成
Runway
帶鏡頭控制的創意影片
Luma
空間感知影片生成
Suno
文字生成 AI 音樂
ElevenLabs
文字轉語音及語音 AI
GPT
OpenAI 對話與 Responses API
Claude
Anthropic Messages API
DeepSeek
平價 LLM，內建推理能力
Gemini
Google AI 模型，無需 GCP
Nano Banana
Google 圖像生成，支援文字渲染
Midjourney
Midjourney AI 圖像生成、圖片編輯和圖生影片
Ideogram V3
專注排版的圖像生成
Recraft
向量藝術及圖像放大
Flux 2
BFL 圖像生成，Pro 及 Flex 版本
GPT Image
OpenAI 圖像生成與編輯
Hermes Agent 設定常見問題
可以。Hermes Agent 支援模型選擇和自訂 endpoint。請將具名的自訂 provider 設定為使用 RunAPI /v1 base URL，將 API key 保留在 RUNAPI_API_KEY，並選擇例如 gpt-5.2 的 RunAPI model。
當你想用引導式選擇器時，請使用 hermes model。當你需要可重複套用到 server 或共享環境的設定時，請編輯 config file。無論哪種方式，之後都應以 hermes doctor 驗證。
請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動方式不一定會繼承你互動式 shell 的變數。
可以。將 RunAPI 加入為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你要在已設定的模型之間切換時，請使用 hermes model 或 /model 指令。