> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GetModelsRequest

## Fields

| Field                      | Type                                                                            | Required             | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Example          |
| -------------------------- | ------------------------------------------------------------------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- |
| `http_referer`             | *Optional\[str]*                                                                | :heavy\_minus\_sign: | The app identifier should be your app's URL and is used as the primary identifier for rankings.<br />This is used to track API usage per application.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                  |
| `x_open_router_title`      | *Optional\[str]*                                                                | :heavy\_minus\_sign: | The app display name allows you to customize how your app appears in OpenRouter's dashboard.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                  |
| `x_open_router_categories` | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Comma-separated list of app categories (e.g. "cli-agent,cloud-agent"). Used for marketplace rankings.<br />                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |                  |
| `category`                 | [Optional\[operations.GetModelsCategory\]](../operations/getmodelscategory.mdx) | :heavy\_minus\_sign: | Filter models by use case category                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | programming      |
| `supported_parameters`     | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by supported parameter (comma-separated)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | temperature      |
| `output_modalities`        | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by output modality. Accepts a comma-separated list of modalities (text, image, audio, embeddings) or "all" to include all models. Defaults to "text".                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | text             |
| `sort`                     | [Optional\[operations.GetModelsSort\]](../operations/getmodelssort.mdx)         | :heavy\_minus\_sign: | 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 (Artificial Analysis intelligence index), 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           |
| `q`                        | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Free-text search by model name or slug.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | gpt-4            |
| `input_modalities`         | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by input modality. Comma-separated list of: text, image, audio, file.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | text,image       |
| `context`                  | *Optional\[int]*                                                                | :heavy\_minus\_sign: | Minimum context length (tokens). Models with smaller context are excluded.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | 128000           |
| `min_price`                | *OptionalNullable\[float]*                                                      | :heavy\_minus\_sign: | Minimum prompt price in \$/M tokens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 0                |
| `max_price`                | *OptionalNullable\[float]*                                                      | :heavy\_minus\_sign: | Maximum prompt price in \$/M tokens.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | 10               |
| `arch`                     | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | GPT              |
| `model_authors`            | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by the organization that created the model. Comma-separated list of author slugs.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | openai,anthropic |
| `providers`                | *Optional\[str]*                                                                | :heavy\_minus\_sign: | Filter models by hosting provider. Comma-separated list of provider names.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | OpenAI,Anthropic |
| `distillable`              | [Optional\[operations.Distillable\]](../operations/distillable.mdx)             | :heavy\_minus\_sign: | Filter by distillation capability. "true" returns only distillable models, "false" excludes them.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | true             |
| `zdr`                      | [Optional\[operations.Zdr\]](../operations/zdr.mdx)                             | :heavy\_minus\_sign: | When set to "true", return only models with zero data retention endpoints.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | true             |
| `region`                   | [Optional\[operations.Region\]](../operations/region.mdx)                       | :heavy\_minus\_sign: | Filter to models with endpoints in the given data region. Currently only "eu" is supported.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | eu               |