mcpField
9
9router

9router

github.com/decolua開発31.6k214 回インストール今日更新
リポジトリ

9router について

9routerは、OpenAI互換のREST APIを通じてローカルまたはリモートのAIゲートウェイを利用するスキルです。モデルの機能を確認し、複数のプロバイダーへのリクエストと自動フォールバックを扱います。

主な機能

  1. 01OpenAI互換のRESTリクエスト
  2. 02機能別のモデル検索
  3. 03プロバイダーの組み合わせと自動フォールバック
  4. 04チャット、画像、音声、埋め込み、ウェブ検索のスキル

活用シーン

  1. 01機能に対応するモデルIDの確認
  2. 02設定済みゲートウェイ経由でのリクエスト
  3. 03プロバイダー障害時のフォールバック利用

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/decolua/9router --skill 9router

インストール後、Claude Code で/9routerを入力して読み込まれたか確認します。

詳細

9Router

OpenAI 互換の REST を公開するローカル／リモート AI ゲートウェイです。1 つのキーで複数のプロバイダーを利用でき、自動でフォールバックします。

セットアップ

export NINEROUTER_URL="http://localhost:20128"      # or VPS / tunnel URL
export NINEROUTER_KEY="sk-..."                      # from Dashboard → Keys (only if requireApiKey=true)

すべてのリクエストは、Authorization: Bearer ${NINEROUTER_KEY} ヘッダー（認証が無効な場合は省略）を指定して、${NINEROUTER_URL}/v1/... に送信します。

確認：curl $NINEROUTER_URL/api/health → {"ok":true}

モデルを確認する

curl $NINEROUTER_URL/v1/models                  # chat/LLM (default)
curl $NINEROUTER_URL/v1/models/image            # image-gen
curl $NINEROUTER_URL/v1/models/tts              # text-to-speech
curl $NINEROUTER_URL/v1/models/embedding        # embeddings
curl $NINEROUTER_URL/v1/models/web              # web search + fetch (entries have `kind` field)
curl $NINEROUTER_URL/v1/models/stt              # speech-to-text
curl $NINEROUTER_URL/v1/models/image-to-text    # vision

リクエストの model フィールドには data[].id を使用します。コンボは owned_by:"combo" として表示されます。

レスポンスの形式：

{ "object": "list", "data": [
  { "id": "openai/gpt-5", "object": "model", "owned_by": "openai", "created": 1735000000 },
  { "id": "tavily/search", "object": "model", "kind": "webSearch", "owned_by": "tavily", "created": 1735000000 }
]}

機能スキル

ユーザーが特定の機能を必要としている場合は、該当するスキルの SKILL.md を raw URL から取得してください。

機能Raw URL
チャット／コード生成https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-chat/SKILL.md
画像生成https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-image/SKILL.md
テキスト読み上げhttps://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-tts/SKILL.md
音声認識https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-stt/SKILL.md
埋め込みhttps://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-embeddings/SKILL.md
ウェブ検索https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-search/SKILL.md
ウェブ取得（URL → markdown）https://raw.githubusercontent.com/decolua/9router/refs/heads/master/skills/9router-web-fetch/SKILL.md

エラー

  • 401 → NINEROUTER_KEY を設定／更新します（Dashboard → Keys）
  • 400 Invalid model format → /v1/models/<kind> に model が存在することを確認します
  • 503 All accounts unavailable → retry-after を待つか、別のプロバイダーアカウントを追加します

コメント

Markdown 対応