omni-models

Original：🇺🇸 English

Translated

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

7installs

Sourcecheaper-inference/omniroute

Added on2026-10-22

NPX Install

npx skill4agent add cheaper-inference/omniroute omni-models

SKILL.md Content

View Translation Comparison →

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

,

) are opt-in: without them the response is unchanged. They narrow the caller's own (key-filtered) catalog and run before

limit

/

after

paging.

bash

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).

bash

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)

bash

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

POST /api/models/alias

Create or update a model alias

bash

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

bash

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

GET /api/models/openrouter-catalog

GET models › openrouter catalog

bash

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

POST /api/models/test

POST models › test

bash

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

bash

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 › <model>

bash

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.

omni-models

NPX Install

Tags

SKILL.md Content

Overview

Authentication

Endpoints

GET /api/v1/models

POST /api/v1/models/query

GET /api/models

POST /api/models/alias

GET /api/models/catalog

GET /api/models/openrouter-catalog

POST /api/models/test

POST /api/models/test-all

GET /api/v1/models/{model}

Payloads