--- title: Hermes Agentにカスタムプロバイダーを追加する方法（2026年） description: >- Hermes AgentをOpenAI互換のプロバイダーに接続。MiniMax、DeepSeek、Gemini、Grok、OpenAI、またはhaimaker.ai。ベースURL、APIキー、タイムアウトの解決策。 date: 2026-05-11T00:00:00.000Z updatedDate: 2026-06-26T00:00:00.000Z location: サンフランシスコ（カリフォルニア州）– 2026年5月11日 image: /images/hermes-custom-provider-setup-hero.jpg keywords: >- hermes agent カスタムプロバイダー, hermes agent プロバイダー設定, hermes agent apiキー, hermes agent minimax プロバイダー設定, hermes agent gemini api, hermes agent deepseek 設定, hermes agent grok api, hermes カスタムエンドポイント, hermes agent openai互換api faq: - question: Hermes Agentにカスタムプロバイダーを追加するには？ answer: >- ターミナルで`hermes model`を実行し、「Custom endpoint」を選び、プロバイダーのベースURL（末尾が/v1）、APIキー、モデル識別子の3つを入力します。Hermesは選択内容を保存し、以降のすべての実行で使用します。OpenAI互換の/v1/chat/completionsエンドポイントを公開しているプロバイダーなら、MiniMax、DeepSeek、Google、xAI、OpenAI、OpenRouter、ローカルのOllamaインスタンス、haimaker.aiまで、どれでも動作します。haimaker.aiの場合は「npx -y @haimaker/connect --hermes」で1コマンドで設定できます。 - question: Hermes Agentに必要なベースURLは？ answer: >- Hermesには完全なchat-completionsパスではなく、OpenAI互換のルートURLが必要です。haimaker.aiならhttps://api.haimaker.ai/v1、MiniMaxにはhttps://api.minimax.io/v1、DeepSeekにはhttps://api.deepseek.com/v1、GeminiのOpenAI互換レイヤーにはhttps://generativelanguage.googleapis.com/v1beta/openai、xAI、MiniMaxにはhttps://api.minimax.io/v1、DeepSeekにはhttps://api.deepseek.com/v1、GeminiのOpenAI互換レイヤーにはhttps://generativelanguage.googleapis.com/v1beta/openai、xAI、MiniMaxならhttps://api.minimax.io/v1、DeepSeekならhttps://api.deepseek.com/v1、GeminiのOpenAI互換レイヤーならhttps://generativelanguage.googleapis.com/v1beta/openai、xAI、MiniMaxならhttps://api.minimax.io/v1、DeepSeekならhttps://api.deepseek.com/v1、GeminiのOpenAI互換レイヤーならhttps://generativelanguage.googleapis.com/v1beta/openai、xAI Grokならhttps://api.x.ai/v1、OpenAIにはhttps://api.openai.com/v1、Ollamaにはhttp://localhost:11434/v1を使用してください。Hermesが自動的に/chat/completionsを付与します。、OpenAIにはhttps://api.openai.com/v1、Ollamaにはhttp://localhost:11434/v1を使用します。Hermesが自動的に/chat/completionsを付与します。、OpenAIならhttps://api.openai.com/v1、Ollamaならhttp://localhost:11434/v1を使います。Hermesが/chat/completionsを自動で付加します。、OpenAIならhttps://api.openai.com/v1、Ollamaならhttp://localhost:11434/v1を使用してください。Hermesが自動的に/chat/completionsを追加します。 - question: Hermesのカスタムプロバイダーでタイムアウトが発生するのはなぜ？ answer: >- 低速なプロバイダーで長いエージェント処理を実行すると、Hermesのデフォルトの読み取りタイムアウトを超えることがあります。Hermesを起動する前に、環境変数HERMES_STREAM_READ_TIMEOUT（秒単位）により大きな値を設定してください。また、ベースURLの末尾が/v1であり、末尾にスラッシュが付いていないことも確認してください。タイムアウトではなく401が返る場合はAPIキーが反映されていません。`hermes model`を再実行して、キーを再入力してください。 locale: ja-jp translationKey: hermes-custom-provider-setup --- Hermes Agentには少数の組み込みプロバイダーが用意されていますが、真の柔軟性は**カスタムエンドポイント**オプションにあります。OpenAIのchat-completions形式に対応したサービスであれば、ベースURL、APIキー、モデル名の3つだけで接続できます。MiniMax、DeepSeek、Google Gemini、xAI Grok、OpenAI、OpenRouter、プライベートなvLLMサーバー、ローカルのOllamaインスタンス、そしてこれらすべてをまとめて利用できる[haimaker.ai](https://haimaker.ai)にも対応しています。 ここではまず一般的な設定方法を説明し、その後、よく使われるプロバイダーごとの具体的な値を紹介します。 ## 一般的な設定方法 Hermesでは、どのカスタムプロバイダーも以下の流れで設定します。 ```bash hermes model ``` 1. メニューから**Custom endpoint**を選択します。 2. **ベースURL**を入力します。OpenAI互換のルートURLで、末尾は`/v1`です（Hermesが自動的に`/chat/completions`を追加します）。 3. そのプロバイダーの**APIキー**を入力します。 4. プロバイダーが求める**モデル識別子**を入力します。 Hermesは選択内容を保存し、以降のすべての実行で使用します。プロバイダーを変更するときは、もう一度`hermes model`を実行してください。仕組みはこれだけです。残りは各プロバイダーに合わせた正しい値を埋めるだけです。 Hermesでモデルがうまく動作するには、ツールスキーマに従いつつ、エージェントのループ処理に対応できる十分なコンテキスト長を備えている必要があります。最低でも約64Kの利用可能なコンテキストを確保してください。実際にどのモデルを選ぶべきかは[Hermes Agentに最適なモデル](/blog/best-models-for-hermes/)を参照してください。 ## haimaker.ai：1つのキーですべてのモデルにアクセス プロバイダーごとに別々のアカウント、キー、ベースURLを管理する代わりに、Hermesをhaimaker.aiへ一度接続すれば、モデルの切り替えは1つの文字列を変更するだけです。最も早いセットアップ方法は、次の1コマンドです。 ```bash export HAIMAKER_API_KEY=your-haimaker-key npx -y @haimaker/connect --hermes ``` [`@haimaker/connect`](/connect)はHermesのカスタムエンドポイント設定を書き込み、キーを検証してから終了します。`--model`を付けるとモデルを固定できます。`--pick-model`を付けると対話形式で選択できます。元に戻すには`npx @haimaker/connect --uninstall --hermes`を実行します。まず[app.haimaker.ai](https://app.haimaker.ai/sign-up)でキーを取得してください。新規アカウントには無料クレジットが付与されます。 組み込みの`hermes model`フローを使いたい場合は、以下の値を入力してください。 - **ベースURL：** `https://api.haimaker.ai/v1` - **APIキー：** haimaker.aiのキー - **モデル：** 対応モデルなら何でも。例：`anthropic/claude-sonnet-4-6`、`openai/gpt-5-4-codex`、`google/gemini-3-1-pro`、`minimax/minimax-m2-5`、`deepseek/deepseek-v3-2`、`xai/grok-4-1-fast`、`zai/glm-4-7`、`moonshot/kimi-k2-5` モデルは市場価格より約5%安く、請求アカウントの管理は1つだけで済みます。 ## HermesでMiniMaxを使う MiniMax M2.5は、Hermesで人気のコストパフォーマンスに優れた選択肢です。常時稼働させても気にならない価格で、ツールループを処理できる性能があります。 - **ベースURL：** `https://api.minimax.io/v1` - **APIキー：** MiniMaxプラットフォームのコンソールから取得 - **モデル：** `MiniMax-M2.5`（MiniMaxコンソールに表示される正確なIDを使用してください。大文字と小文字は区別されます） または、haimaker.ai経由でモデル`minimax/minimax-m2-5`を使えば、個別のアカウントは不要です。 ## HermesでGoogle Geminiを使う GeminiはOpenAI互換レイヤーを提供しているため、Hermesのカスタムエンドポイントとして利用できます。 - **ベースURL：** `https://generativelanguage.googleapis.com/v1beta/openai` - **APIキー：** Google AI Studioのキー - **モデル：** 安価で高速な処理なら`gemini-3-flash`、長文コンテキストのリサーチなら`gemini-3.1-pro` Hermes Agentはこの方法でGoogle Geminiをサポートしています。別途Gemini専用の統合を有効にする必要はなく、カスタムエンドポイントとして接続するだけです。haimaker.ai経由で`google/gemini-3-1-pro`を使うこともできます。 ## HermesでDeepSeekを使う - **ベースURL：** `https://api.deepseek.com/v1` - **APIキー：** DeepSeekプラットフォームから取得 - **モデル：** `deepseek-chat`（現在のV3.2系を指します）または`deepseek-reasoner` haimaker.ai経由の場合：`deepseek/deepseek-v3-2` ## HermesでxAI Grokを使う - **ベースURL：** `https://api.x.ai/v1` - **APIキー：** xAIコンソールから取得 - **モデル：** 安価な大規模コンテキスト処理なら`grok-4.1-fast`、コード特化のタスクなら`grok-code-fast` haimaker.ai経由の場合：`xai/grok-4-1-fast` ## HermesでOpenAI / Codexモデルを使う OpenAIのモデル（Codexシリーズを含む）をHermes経由で使いたい場合： - **ベースURL：** `https://api.openai.com/v1` - **APIキー：** OpenAIの**API**キー（ChatGPT PlusのサブスクリプションにはAPIアクセスは含まれません。課金が有効な別途のAPIキーが必要です） - **モデル：** コーディングには`gpt-5.4-codex`、汎用的な作業には`gpt-5.4` haimaker.ai経由の場合：`openai/gpt-5-4-codex` ## Ollama経由のローカルモデル - **ベースURL：** `http://localhost:11434/v1` - **APIキー：** 空でない文字列なら何でも可（Ollamaは無視しますが、Hermesは値が必要です） - **モデル：** `gemma4:latest`、`qwen3.5:latest`、またはpull済みの任意のモデル ```bash ollama pull gemma4 hermes model # Custom endpoint → base URL above → model gemma4:latest ``` ## よくある問題 - **長い処理でのタイムアウト。** 低速なプロバイダーでは、長いエージェント処理の途中でHermesのデフォルトのストリーム読み取りタイムアウトを超えることがあります。Hermesを起動する前に`HERMES_STREAM_READ_TIMEOUT`（秒）をより大きな値に設定してください。 - **401 / 認証エラー。** キーが正しく登録されていないか、APIキーではなくコンソール/セッショントークンを貼り付けた可能性があります。`hermes model`を再実行して、キーを再入力してください。 - **リクエストで404が返る。** ベースURLにすでに`/chat/completions`が含まれているか、末尾にスラッシュがある可能性があります。Hermesがパスを自動的に追加するため、URLは`/v1`で終わるようにしてください。 - **ツール呼び出しが繰り返し失敗する。** 通常は設定ではなくモデル側の問題です。小規模モデルはツールスキーマから外れやすいため、上位のモデルに切り替えてください。 ## haimaker.aiのキーを取得する 新規アカウントにはテスト用の無料クレジットが付与されます。[haimaker.ai](https://haimaker.ai)で、対応モデルを最新の価格とベンチマーク付きで確認できます。その上で`npx -y @haimaker/connect --hermes`を実行して、Hermesを接続してください。 HAIMAKERで10ドル分の無料クレジットを獲得 --- *関連記事：[Hermes Agentに最適なモデル](/blog/best-models-for-hermes/) · [Hermes Agentの料金](/blog/hermes-api-costs-pricing/) · [Hermes Agent vs Codex CLI](/blog/hermes-vs-codex/)*