在 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 指令、參數說明與常見問題。
從音訊生成口型同步頭像影片
xAI 圖像與影片生成
文字引導圖像編輯
快速雙語圖像生成
AI 圖像與影片超解析度
Google 圖像生成
字節跳動 4K 圖像生成
阿里巴巴圖像生成與編輯
帶動態控制和音效的影片生成
Google 電影級影片與原生音訊
字節跳動的經濟型影片生成
MiniMax 影片,附帶每日免費額度
開源影片與圖像生成
帶攝影機控制的創意影片
具空間感知的影片生成
從文字生成 AI 音樂
文字轉語音與聲音 AI
OpenAI 聊天與 Responses API
Anthropic Messages API
經濟型推理 LLM
Google AI 模型,無需 GCP
帶文字渲染的 Google 圖像生成
專注排版的圖像生成
向量藝術與圖像放大
BFL 圖像生成,pro 與 flex
OpenAI 圖像生成與編輯
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 指令。