OmniRoute のローカルインストールと起動の検証

このページは、最短の OmniRoute セットアップパスを必要とする初めてのHagiCode ユーザーを対象としています。ローカルサービスを開始し、それを確認します。 http://localhost:20128/v1 が動作し、ダッシュボードと API の両方が利用可能であることを確認します。

前提条件

Node.js はすでにインストールされています。完了 Node.jsのインストール必要に応じて最初に。
ローカルポート 20128 利用可能ですが、まだ占有されていません。
OmniRoute 経由でルーティングする予定のアップストリームモデルプロバイダーアカウントが少なくとも 1 つあります。
HagiCode、CLI、または SDK を統合する前に、次の 2 つのアドレスを分離しておきます。
- ダッシュボード: http://localhost:20128
- OpenAI 互換のベース URL: http://localhost:20128/v1

ローカルにインストールして実行する

推奨されるグローバル npm パスから始めます。

npm install -g omniroute
omniroute

サービスが開始されたら、次の順序で検証します。

開く http://localhost:20128 ブラウザでをクリックし、ダッシュボードが読み込まれることを確認します。
に行きます Endpoints ダッシュボードのページに移動し、API キーを作成またはコピーします。
後でツールに渡すベース URL をメモします。 http://localhost:20128/v1.

実行中のサービスを検証する

検証 1: モデルカタログが読み取り可能であることを確認する

からキーを入れます Endpoints 環境変数にページを追加します。

export OMNIROUTE_API_KEY="replace-with-the-key-you-copied-from-the-Endpoints-page"

それからリクエストしてください /v1/models:

curl http://localhost:20128/v1/models \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}"

モデルのリストが返された場合、OpenAI 互換のエンドポイントと認証フローは機能しています。

検証 2: 最小限のチャットリクエストを送信する

curl http://localhost:20128/v1/chat/completions \
  -H "Authorization: Bearer ${OMNIROUTE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "replace-with-a-model-id-from-v1-models",
    "messages": [
      { "role": "user", "content": "Reply with ok." }
    ]
  }'

ここでの目標は、迅速な品質ではありません。これは、選択したモデルがすでに OmniRoute を正常にルーティングできることを証明するためです。

次のステップ

Installing Node.js

AI Agent CLI Installation

OmniRoute Upstream Project