Example Usage
import { ListModelsUserRequest } from "@openrouter/sdk/models/operations";
let value: ListModelsUserRequest = {};
Fields
| Field | Type | Required | Description | Example |
|---|---|---|---|---|
httpReferer | string | ➖ | The app identifier should be your app’s URL and is used as the primary identifier for rankings. This is used to track API usage per application. | |
appTitle | string | ➖ | The app display name allows you to customize how your app appears in OpenRouter’s dashboard. | |
appCategories | string | ➖ | Comma-separated list of app categories (e.g. “cli-agent,cloud-agent”). Used for marketplace rankings. | |
offset | number | ➖ | Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned | 0 |
limit | number | ➖ | Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned | 500 |
outputModalities | string | ➖ | Filter models by output modality. Accepts a comma-separated list of modalities (text, image, embeddings, audio, video, rerank, decisions, speech, transcription) or “all” to include all models. Defaults to “text”. | text |
sort | operations.ListModelsUserSort | ➖ | Sort the returned models server-side. Prefer this over fetching the full list and sorting client-side. Options: pricing-low-to-high, pricing-high-to-low (average prompt/completion price), context-high-to-low (context length), throughput-high-to-low, latency-low-to-high (recent median performance), most-popular, top-weekly (tokens processed in the last week), newest (creation date), intelligence-high-to-low, coding-high-to-low, agentic-high-to-low (Artificial Analysis indices), design-arena-elo-high-to-low (best Design Arena ELO across arenas). Models without a score for the chosen benchmark are placed last. When omitted, the existing default ordering is preserved. | newest |