在 Hermes Agent 使用 RunAPI。
Hermes Agent 可以將自訂的 OpenAI 相容 endpoint 用於聊天模型。把提示詞複製到 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.5
export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes
用提示詞在 Hermes Agent 中安裝 RunAPI
貼上設定提示詞
把第一個分頁中的提示詞複製到 Hermes Agent。它會指示 Hermes Agent 讀取 RUNAPI_API_KEY,並將 RunAPI 新增為具名的自訂 provider。
Copy prompt
檢查產生的設定
Hermes Agent 應將 provider 設為 custom:runapi,預設為 gpt-5.2,並將 key_env 指向 RUNAPI_API_KEY。
provider: custom:runapi
執行診斷
編輯設定後先執行 hermes doctor,然後開啟 Hermes Agent 並送出一段簡短測試提示詞,再用於較大型的任務。
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 金鑰,而不是硬編碼。 |
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。
瀏覽圖像模型在 Hermes Agent 中使用任何模型
每份指南都包含在 Hermes Agent 中透過 RunAPI 呼叫特定模型所需的提示詞、curl 指令、參數說明與常見問題。
Claude
Text · Anthropic
DeepSeek
Text · DeepSeek
ElevenLabs
Audio & Music · ElevenLabs
Embedding
Text · OpenAI
Fish Audio
Audio & Music · Fish Audio
Flux
Image · Black Forest Labs
Flux 2
Image · Black Forest Labs
Flux Kontext
Image · Black Forest Labs
Gemini
Text · Google
Gemini Omni
Video · Google
Gemini TTS
Audio & Music · Google
GLM
Text · Z.ai
GPT
Text · OpenAI
GPT Image
Image · OpenAI
GPT Image 2
Image · OpenAI
GPT-4o Image
Image · OpenAI
Grok
Text · xAI
Grok Imagine
Video · xAI
Hailuo
Video · MiniMax
HappyHorse
Video · Alibaba
Ideogram V3
Image · Ideogram
Imagen 4
Image · Google
InfiniteTalk
Video · MeiGen-AI
Kimi
Text · Moonshot AI
Kling
Video · Kuaishou
Luma
Video · Luma
Midjourney
Utility · Midjourney
MiMo
Text · Xiaomi
MiniMax
Text · MiniMax
MiniMax H3
Video · MiniMax
Nano Banana
Image · Google
OmniHuman
Utility · Bytedance
OpenAI Transcription
Audio & Music · OpenAI
OpenAI TTS
Audio & Music · OpenAI
PixVerse
Video · PixVerse
Producer
Audio & Music · Producer
Qwen 2
Image · Alibaba
Qwen 3
Image · Alibaba
Qwen Image
Image · Alibaba
Recraft
Utility · Recraft
Runway
Video · Runway
Runway Aleph
Video · Runway
Seedance
Video · Bytedance
Seedream
Image · Bytedance
Suno
Audio & Music · Suno
Topaz
Utility · Topaz
Veo 3.1
Video · Google
Volcengine Lip Sync
Video · Bytedance
Wan
Video · Alibaba
Z Image
Image · Alibaba
Hermes Agent 設定常見問題
可以。Hermes Agent 支援模型選擇與自訂 endpoint。請用 RunAPI /v1 base URL 設定具名的自訂 provider,將 API key 保存在 RUNAPI_API_KEY,並選擇像 gpt-5.2 這類 RunAPI 模型。
當你想使用引導式選單時,請用 hermes model。當你需要伺服器或共享環境的可重複設定時,請編輯設定檔。無論哪種方式,之後都要用 hermes doctor 驗證。
請在啟動 Hermes Agent 的同一個 shell、service unit 或 gateway 環境中設定 RUNAPI_API_KEY。GUI 或 daemon 啟動時,不一定會繼承你的互動式 shell 變數。
可以。將 RunAPI 新增為 custom:runapi 不會移除其他 Hermes Agent 模型選項。當你想在已設定的模型之間切換時,請使用 hermes model 或 /model 指令。