Hermes Agent で RunAPI を使う。
Hermes Agent はチャットモデル用の OpenAI 互換カスタムエンドポイントを利用できます。Prompt を Hermes Agent に貼り付け、custom 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
Prompt で Hermes Agent に RunAPI を設定する
セットアップ Prompt を貼り付ける
最初のタブの Prompt を Hermes Agent にコピーします。RUNAPI_API_KEY を読み込み、RunAPI を名前付き custom provider として追加するよう Hermes Agent に指示します。
Prompt をコピー
生成された設定を確認する
Hermes Agent は provider を custom:runapi にし、デフォルトを gpt-5.2 に設定し、key_env が RUNAPI_API_KEY を指す必要があります。
provider: custom:runapi
診断を実行する
設定を編集したら hermes doctor を実行し、その後 Hermes Agent を開いて短いテスト Prompt を送ってから大きなタスクに使ってください。
hermes doctor
設定項目
| 項目 | 値 | 目的 |
|---|---|---|
custom_providers.name |
runapi |
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 エンドポイント経由で 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 でどのモデルでも使う
各ガイドでは、RunAPI を通じて Hermes Agent 内の特定のモデルを呼び出すためのプロンプト、curl コマンド、パラメーター、FAQ を紹介します。
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 はモデル選択とカスタムエンドポイントに対応しています。名前付き custom provider に RunAPI の /v1 base URL を設定し、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 コマンドを使ってください。
Hermes Agent で 1つの RunAPI key を使う。
カタログからモデルを選び、カスタムエンドポイントを設定して、次の agent 実行前に Hermes Agent を確認します。