mcpField
O
omni-models

omni-models

github.com/diegosouzapwDevelopment82.9k971 installsUpdated today
Repository

About omni-models

omni-models documents OmniRoute API endpoints for discovering and querying models across configured providers. It is intended for clients and administrators that need filtered catalogs or model aliases.

Key features

  1. 01List models available by provider
  2. 02Filter and page through model results
  3. 03Query a bounded model shortlist
  4. 04Create or update model aliases
  5. 05Retrieve the full model catalog

Use cases

  1. 01Finding models visible to an API key
  2. 02Filtering models by capability or context
  3. 03Building a shortlist for an application
  4. 04Managing model aliases

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/diegosouzapw/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