omni-models について
omni-modelsは、認証が必要なOmniRouteのモデルAPIエンドポイントを説明します。設定済みプロバイダーのモデル検索、カタログ閲覧、別名設定、モデルテストに対応します。
主な機能
- 01設定済みプロバイダーのモデル一覧
- 02モデル結果の絞り込みとページ表示
- 03件数上限付きモデル候補の取得
- 04モデル別名の作成・更新
- 05全カタログとOpenRouterカタログの閲覧
- 06単一または全モデルのテスト
活用シーン
- 01APIキーから参照可能なモデルの確認
- 02機能やコンテキスト長によるカタログ絞り込み
- 03別名を使ったモデルの解決
- 04テスト用エンドポイントでモデルの利用可否を確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ cheaper-inference/ omniroute --skill omni-modelsインストール後、Claude Code で/omni-modelsを入力して読み込まれたか確認します。
詳細
概要
設定済みのすべてのプロバイダーで利用可能な AI モデルを検索します。モデルの一覧表示、モデルエイリアスの解決、プロバイダー固有のバリエーションを含むモデルカタログ全体の参照ができます。
認証
すべてのリクエストには、有効な Bearer トークンまたはセッション Cookie が必要です。POST /api/auth/login でトークンを取得するか、ローカル開発では REQUIRE_API_KEY=false を設定してください。
エンドポイント
GET /api/v1/models
利用可能なモデルを一覧表示します
設定済みのプロバイダー全体で利用可能なすべてのモデルを返します。検索フィルター(capability、min_context、kind、q)はオプトインです。指定しない場合、レスポンスは変わりません。フィルターは呼び出し元自身の(キーでフィルターされた)カタログを絞り込み、limit/after によるページングの前に適用されます。
curl http://localhost:20128/api/v1/models \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/v1/models/query
モデル候補を検索します
GET /v1/models と同じカタログ(認証とキーごとの可視性も同じ)を対象に、フィルターされた候補を返します。結果は owned_by、次に id の順に並べられ、limit(デフォルトは 20、最大 100)件に制限されます。
curl -X POST http://localhost:20128/api/v1/models/query \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/models
モデルを一覧表示します(管理用)
curl http://localhost:20128/api/models \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/alias
モデルエイリアスを作成または更新します
curl -X POST http://localhost:20128/api/models/alias \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/models/catalog
モデルカタログ全体を取得します
curl http://localhost:20128/api/models/catalog \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/models/openrouter-catalog
モデル › OpenRouter カタログを取得します
curl http://localhost:20128/api/models/openrouter-catalog \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/test
モデル › テスト
curl -X POST http://localhost:20128/api/models/test \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
POST /api/models/test-all
モデル › すべてテスト
curl -X POST http://localhost:20128/api/models/test-all \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
GET /api/v1/models/{model}
モデル › を取得します
curl http://localhost:20128/api/v1/models/{model} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
ペイロード
リクエスト/レスポンスのスキーマの詳細については、完全な OpenAPI 仕様(GET /api/openapi/spec または docs/openapi.yaml)を参照してください。