Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-modelsPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->
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 › <model>
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.
