cheaper-inference/omniroute

omni-models

Query available AI models across all configured providers.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/cheaper-inference/omniroute --skill omni-models

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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

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/v1/models/health

Per-model pause state for the caller's key

Read-only liveness view over the in-memory model lockout store. ok means no pause observed by this instance (not a health verdict); connection-level pauses live outside the store read here. Additive: leaves GET /v1/models and its cache untouched. retry_after carries the shortest remaining lockout in seconds, rounded up, only when state is cooling. One documented difference from the dispatch 429 model_cooldown rule: a model with one lockout-covered connection and one connection-level cooldown still reads cooling here, while the 429 requires every connection to carry a model cooldown.

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

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.

같은 저장소의 Skills

더 많은 Skills

모든 Skills