APIMaster.ai
APIMaster.ai ドキュメント
Quick startAPIMaster.aiMarketplace

APIMaster.ai と Hermes Desktop

Windows または macOS の Hermes Desktop で OpenAI 互換の API キーとベース URL を設定し、設定でモデルを選択します。

APIMaster.ai は OpenAI 互換 です。Hermes は2つの環境変数を読み取り、デスクトップ UI でモデルを選択します。

クイックセットアップ

ステップ1 — API キーを取得する

  1. APIMaster コンソール を開きます。
  2. API キー をコピーします（通常は sk- で始まります）。
  3. 実際のキーをチャットやスクリーンショットに貼り付けないでください。代わりにプレースホルダー your_apimaster_key を使用してください。

ステップ2 — .env ファイルを編集する

Windows

  1. Win + R を押して、以下を貼り付け、Enter キーを押します：

    %LOCALAPPDATA%\hermes

  2. .env をメモ帳で開きます（ファイルがない場合は作成します）。

  3. 一般的なフルパス：

    C:\Users\YourName\AppData\Local\hermes\.env

macOS

Hermes Desktop は CLI と ~/.hermes を共有します（公式ドキュメント）。キーを ~/.hermes/.env に配置します。

オプション A — Finder（推奨）

  1. 移動 → フォルダへ移動… (Shift + Command + G) を選択します。

  2. 以下を貼り付けます：

    ~/.hermes

    （~ はホームフォルダです；.hermes は「フォルダへ移動」を使用しない限り Finder では隠しファイルです。）

  3. .env をテキストエディットで開きます（ファイルがない場合は作成します）。

オプション B — ターミナル

open ~/.hermes

フルパス

/Users/YourName/.hermes/.env

ステップ3 — 以下の行を追加する

OPENAI_API_KEY=your_apimaster_key
OPENAI_BASE_URL=https://apimaster.ai/v1
  • OPENAI_BASE_URL は /v1 で終わる必要があります — https://apimaster.ai 単体ではありません。
  • = の前後にスペースを入れず、Hermes のドキュメントで指定がない限り引用符は使用しないでください。
  • ファイルを保存します。

ステップ4 — Hermes Desktop を再起動する

Hermes を完全に終了し（トレイアイコンも含む）、再度開きます。

アプリ内でモデルを選択する

  1. Hermes Desktop を開きます。

  2. 設定 → モデル → メインモデル に移動します。

  3. プロバイダー: カスタムエンドポイント。

  4. モデル: サポートされている モデル ID を選択します。例：

    • claude-opus-4-8
    • claude-sonnet-4-6
    • gpt-5.5
    • gpt-5.4

    完全なリストについては マーケットプレイス または管理者を参照してください。

  5. 適用 をクリックし、設定を閉じます。

Hermes Desktop: 設定 → モデル → メインモデル

テスト：モデルを選択してメッセージを送信する

1. 設定でメインモデルを設定する（必須）

  1. 設定 を開きます（サイドバーまたは左下）。
  2. モデル → メインモデル に移動します。
  3. プロバイダー: カスタムエンドポイント（表示されている場合は openai-api）。
  4. モデル ドロップダウンを開き、ID（例：gpt-5.4）を クリック します — 表示名を入力しないでください。
  5. 適用 をクリックし、設定を閉じます。

新しいチャットは適用後にこのモデルを使用します。古いチャットは以前のモデルを引き続き使用する場合があります。

2. 新しいチャットを開始する

  1. チャットリストに戻ります。
  2. 新規チャット（または +）をクリックします。
  3. 古いスレッドではなく 新規 セッションを使用します。

3. アクティブなモデルを確認する（推奨）

入力欄の近くに openai-api / gpt-5.4 のような表示があります。正しくない場合は、メインモデルを修正し、適用して、別の 新規 チャットを開いてください。一部のビルドでは、コンポーザーの横に小さなモデルドロップダウンも表示されます。

4. テストメッセージを送信する

Hello, reply with ok と入力し、Enter キーを押します。正常な返信があれば、キー、ベース URL、モデルが動作しています。

5. それでも失敗する場合？

エラーテキスト（401、404、タイムアウト）を確認し、.env 編集後に Hermes が再起動されたことを確認するか、同じキーで API接続テスト を実行してください。

よくある質問

問題 確認事項
送信に失敗する URL が https://apimaster.ai/v1 であること；キーが完全にコピーされていること；モデル ID が正確であること；.env 編集後に Hermes が再起動されていること
フォルダがない Mac では ~/.hermes を使用すること（Application Support ではない）；Hermes を一度起動するか mkdir -p ~/.hermes を実行
カスタムエンドポイントがない Hermes を最新バージョンに更新する
モデルが間違っている ID は APIMaster から提供されます；サポートされているモデル を参照

オプション：同じキーで API接続テスト を実行します。

セキュリティ

  • API キーを Slack、メール、公開ドキュメントで共有 しないでください。
  • チケットやスクリーンショットではプレースホルダーのみを使用してください。
  • 漏洩した場合は、コンソールでキーを無効化し、.env を更新し、Hermes を再起動してください。

チェックリスト

  • コンソールから API キーをコピー（非公開を維持）
  • .env に OPENAI_API_KEY を設定
  • OPENAI_BASE_URL=https://apimaster.ai/v1（/v1 を含む）
  • .env を保存
  • Hermes を完全に再起動
  • プロバイダー = カスタムエンドポイント、モデル ID を選択、適用 をクリック
  • テストメッセージが 新規 セッションで動作

関連情報