/openrouter-models

name: openrouter-models
description: Query OpenRouter for available AI models, pricing, capabilities, throughput, and provider performance. Use when the user asks about available OpenRouter models, model pricing, model context lengths, model capabilities, provider latency or uptime, throughput limits, supported parameters, wants to search/filter/compare models, or find the fastest provider for a model.

OpenRouter Models

Discover, search, and compare the 300+ AI models available on OpenRouter. Query live data including pricing, context lengths, per-provider latency and uptime, throughput, supported modalities, and supported parameters.

Prerequisites

The `OPENROUTER_API_KEY` environment variable is optional for most scripts. It is only required for `get-endpoints.ts` (provider performance data). Get a key at https://openrouter.ai/keys

First-Time Setup

cd <skill-path>/scripts && npm install

Decision Tree

Pick the right script based on what the user is asking:

| User wants to... | Script | Example | |---|---|---| | See all available models | `list-models.ts` | "What models does OpenRouter have?" | | Find recently added models | `list-models.ts --sort newest` | "What are the newest models?" | | Find cheapest models | `list-models.ts --sort price` | "What's the cheapest model?" | | Find highest throughput models | `list-models.ts --sort throughput` | "Which models have the most output capacity?" | | Find models in a category | `list-models.ts --category X` | "Best programming models?" | | Search by name | `search-models.ts "query"` | "Do they have Claude?" | | Resolve an informal model name | `resolve-model.ts "query"` | "Use the nano banana 2.0 model" | | Find image-capable models | `search-models.ts --modality image` | "Which models accept images?" | | Compare specific models | `compare-models.ts A B` | "Compare Claude vs GPT-4o" | | Compare by throughput | `compare-models.ts A B --sort throughput` | "Which has higher throughput, Claude or GPT-4o?" | | Check provider performance | `get-endpoints.ts "model-id"` | "Which provider is fastest for Claude?" | | Find fastest provider | `get-endpoints.ts "model-id" --sort throughput` | "Fastest provider for Claude Sonnet?" | | Find lowest-latency provider | `get-endpoints.ts "model-id" --sort latency` | "Lowest latency provider for GPT-4o?" | | Check model availability | `get-endpoints.ts "model-id"` | "Is Claude Sonnet 4 up right now?" |

Resolve Model

Resolve an informal or vague model name to an exact OpenRouter model ID using fuzzy matching:

cd <skill-path>/scripts && npx tsx resolve-model.ts "claude sonnet"
cd <skill-path>/scripts && npx tsx resolve-model.ts "gpt 4o mini"
cd <skill-path>/scripts && npx tsx resolve-model.ts "llama 3.1"

Results include a `confidence` level and `score`:

| Confidence | Score | Action | |---|---|---| | `high` (≥0.85) | Use the model directly — the match is unambiguous | | `medium` (≥0.55) | Confirm with the user before proceeding | | `low` (≥0.30) | Suggest the matches and ask the user to clarify |

**Two-step workflow:** First resolve the informal name with `resolve-model.ts`, then feed the resolved `id` into other scripts (`compare-models.ts`, `get-endpoints.ts`, etc.).

List Models

cd <skill-path>/scripts && npx tsx list-models.ts

Filter by Category

Server-side category filtering:

cd <skill-path>/scripts && npx tsx list-models.ts --category programming

Categories: `programming`, `roleplay`, `marketing`, `marketing/seo`, `technology`, `science`, `translation`, `legal`, `finance`, `health`, `trivia`, `academia`

Sort Results

cd <skill-path>/scripts && npx tsx list-models.ts --sort newest      # Recently added first
cd <skill-path>/scripts && npx tsx list-models.ts --sort price       # Cheapest first
cd <skill-path>/scripts && npx tsx list-models.ts --sort context     # Largest context first
cd <skill-path>/scripts && npx tsx list-models.ts --sort throughput  # Most output tokens first

Models with upcoming `expiration_date` values trigger a stderr warning.

Search Models

cd <skill-path>/scripts && npx tsx search-models.ts "claude"
cd <skill-path>/scripts && npx tsx search-models.ts --modality image
cd <skill-path>/scripts && npx tsx search-models.ts "gpt" --modality text

Modalities: `text`, `image`, `audio`, `file`

Compare Models

Compare two or more models side-by-side with pricing in per-million-tokens format. Uses exact ID matching — `openai/gpt-4o` matches only that model, not variants like `gpt-4o-mini`.

cd <skill-path>/scripts && npx tsx compare-models.ts "anthropic/claude-sonnet-4" "openai/gpt-4o"
cd <skill-path>/scripts && npx tsx compare-models.ts "anthropic/claude-sonnet-4" "openai/gpt-4o" "google/gemini-2.5-pro" --sort price

Sort options: `price` (cheapest first), `context` (largest first), `speed`/`throughput` (most output tokens first)

Provider Performance (Endpoints)

Get per-provider latency, uptime, and throughput for any model:

cd <skill-path>/scripts && npx tsx get-endpoints.ts "anthropic/claude-sonnet-4"
cd <skill-path>/scripts && npx tsx get-endpoints.ts "anthropic/claude-sonnet-4" --sort throughput
cd <skill-path>/scripts && npx tsx get-endpoints.ts "openai/gpt-4o" --sort latency

Sort options: `throughput` (fastest tokens/sec first), `latency` (lowest p50 ms first), `uptime` (most reliable first), `price` (cheapest first)

Returns for each provider:

• **Latency** (p50/p75/p90/p99 in ms) — median to worst-case response times
• **Throughput** (p50/p75/p90/p99 tokens/sec) — generation speed
• **Uptime** — percentage over the last 30 minutes
• **Status** — `operational` or `degraded`
• **Provider-specific pricing** — some providers offer discounts
• **Supported parameters** — varies by provider (some don't support all features)

API Response Shapes

`GET /api/v1/models` returns `{ data: Model[] }`. For full field reference, see the [