openrouter-models

Offline JSON-backed OpenRouter model catalog (pricing, modalities, status).

Unofficial / community-maintained snapshot. Edit data/*.json then run npm run build:data.

Install

npm install openrouter-models

Quick start

import { listModels, getModel, getMetadata } from "openrouter-models";

const meta = getMetadata();
const models = listModels({ status: "active" });
const one = getModel(models[0]?.id ?? "");

const tagging = meta.requestTagging;
// tagging?.support === "Native (User Tracking & App Identification)"

Request tagging

getMetadata().requestTagging describes how to attribute OpenRouter calls. 0.2.0 support: Native (User Tracking & App Identification).

• user (payload) — end-user id in the dashboard
• HTTP-Referer and X-Title (header) — application identification
• Custom X- headers (passthrough) — forwarded to upstream APM tools such as Langfuse and Portkey

Dataset pin: data-2026.09.24. Package version: 0.2.0.

Updating the catalog

1. Edit data/providers.json and/or data/models.json
2. Bump dataVersion / generatedAt in data/metadata.json
3. Run npm run build:data
4. Run npm test and publish

License

MIT. Not affiliated with OpenRouter. Site: https://openrouter.ai

Monorepo

See docs/MONOREPO.md. Explore in the UI: npm run ui.