mcpField
O
omni-models

omni-models

github.com/cheaper-inferenceDevelopment82.3k1.1k installsUpdated today
Repository

About omni-models

omni-models describes authenticated OmniRoute API endpoints for discovering models across configured providers. It supports catalog browsing, filtered shortlists, model aliases, and model tests.

Key features

  1. 01List models across configured providers
  2. 02Filter and page through model results
  3. 03Query a capped model shortlist
  4. 04Create or update model aliases
  5. 05Browse full and OpenRouter catalogs
  6. 06Test one or all models

Use cases

  1. 01Discover models visible to an API key
  2. 02Narrow a catalog by capability or context
  3. 03Resolve a model through an alias
  4. 04Check model availability with test endpoints

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/cheaper-inference/omniroute --skill omni-models

After installing, type/omni-modelsin Claude Code to confirm it loaded.

Details

From the project README

Overview

Query available AI models across all configured providers. List models, resolve model aliases, and browse the full model catalog including provider-specific variants.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

GET /api/v1/models

List available models

Returns all models available across configured providers. The discovery filters (capability, min_context, kind, q) are opt-in: without them the response is unchanged. They narrow the caller's own (key-filtered) catalog and run before limit/after paging.

curl http://localhost:20128/api/v1/models \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/v1/models/query

Query a model shortlist

Filtered shortlist over the same catalog as GET /v1/models (same auth and per-key visibility). Results are ordered by owned_by, then id, and capped by limit (default 20, maximum 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

List models (management)

curl http://localhost:20128/api/models \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/alias

Create or update a model 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

Get full model catalog

curl http://localhost:20128/api/models/catalog \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/models/openrouter-catalog

GET models › openrouter catalog

curl http://localhost:20128/api/models/openrouter-catalog \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/models/test

POST 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

POST 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}

GET models › 

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

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

Comments

Markdown supported