> ## 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. # List models filtered by user provider preferences, privacy settings, and guardrails > List models filtered by user provider preferences, [privacy settings](https://openrouter.ai/docs/guides/privacy/provider-logging), and [guardrails](https://openrouter.ai/docs/guides/features/guardrails). Returns text-output models by default; pass `output_modalities` (a comma-separated list of `text`, `image`, `embeddings`, `audio`, `video`, `rerank`, `speech`, `transcription`, or `all`) to include other modalities. If requesting through a regional hostname, the results will be filtered to models that satisfy in-region routing for that region. ## OpenAPI ````yaml /openapi/openapi.yaml get /models/user openapi: 3.1.0 info: contact: email: support@openrouter.ai name: OpenRouter Support url: https://openrouter.ai/docs description: OpenAI-compatible API with additional OpenRouter features license: name: MIT url: https://opensource.org/licenses/MIT title: OpenRouter API version: 1.0.0 servers: - description: Production server url: https://openrouter.ai/api/v1 x-speakeasy-server-id: production security: - apiKey: [] tags: - description: API key management endpoints name: API Keys - description: Analytics and usage endpoints name: Analytics - description: Anthropic Messages endpoints name: Anthropic Messages - description: BYOK endpoints name: BYOK - description: >- Submit, list, poll, and delete asynchronous batches of inference requests. See https://openrouter.ai/docs/batch-quickstart. name: Batch - description: Benchmarks endpoints name: Benchmarks - description: Chat completion endpoints name: Chat - description: Task classification market-share endpoints name: Classifications - description: Containers endpoints name: Containers - description: Credit management endpoints name: Credits - description: >- Public OpenRouter usage datasets. Data returned by these endpoints is licensed under CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/): reuse and republish it, including commercially, with attribution to OpenRouter. name: Datasets - description: Text embedding endpoints name: Embeddings - description: Endpoint information name: Endpoints - description: External Users endpoints name: External Users - description: Files endpoints name: Files - description: Generation history endpoints name: Generations - description: Guardrails endpoints name: Guardrails - description: Images endpoints name: Images - description: Model information endpoints name: Models - description: OAuth authentication endpoints name: OAuth - description: Observability endpoints name: Observability - description: Organization endpoints name: Organization - description: Presets endpoints name: Presets - description: Private Endpoints endpoints name: Private Endpoints - description: Private Providers endpoints name: Private Providers - description: Provider information endpoints name: Providers - description: Rerank endpoints name: Rerank - description: OpenAI-compatible Responses API endpoints name: Responses - description: >- Management endpoints for SCIM group-to-workspace mappings, authenticated with a management key. These are not the SCIM 2.0 connector endpoints for your identity provider. In your identity provider, enter the SCIM endpoint URL shown when you enable provisioning under Settings > Members > SCIM Mappings. See https://openrouter.ai/docs/guides/features/scim-mappings#set-up-provisioning. name: SCIM - description: Speech-to-text endpoints name: STT x-displayName: Transcriptions - description: >- System One endpoints for models such as Jev, compatible with the TypeSafe SDKs. See https://openrouter.ai/docs/guides/community/typesafe-sdk. name: SystemOne x-displayName: System One - description: Text-to-speech endpoints name: TTS x-displayName: Speech - description: >- The catalog of server tools OpenRouter runs on behalf of a model: accepted `tools[].type` spellings per API format, engines and pricing, and which endpoints run each tool natively. See https://openrouter.ai/docs/guides/features/server-tools. name: Tools - description: >- Store host-bound secrets for a workspace or for one intern. Scope is selected by the API key. Responses return metadata only, never secret values. See https://openrouter.ai/docs/guides/ori/vault. name: Vault - description: Video Generation endpoints name: Video Generation - description: Workspaces endpoints name: Workspaces - description: Alpha feature endpoints for Decisions requests name: alpha.decisions - description: Alpha feature endpoints for Extractions requests name: alpha.extractions externalDocs: description: OpenRouter Documentation url: https://openrouter.ai/docs paths: /models/user: get: tags: - Models summary: >- List models filtered by user provider preferences, privacy settings, and guardrails description: >- List models filtered by user provider preferences, [privacy settings](https://openrouter.ai/docs/guides/privacy/provider-logging), and [guardrails](https://openrouter.ai/docs/guides/features/guardrails). Returns text-output models by default; pass `output_modalities` (a comma-separated list of `text`, `image`, `embeddings`, `audio`, `video`, `rerank`, `speech`, `transcription`, or `all`) to include other modalities. If requesting through a regional hostname, the results will be filtered to models that satisfy in-region routing for that region. operationId: listModelsUser parameters: - description: >- Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned in: query name: offset required: false schema: default: 0 description: >- Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned example: 0 minimum: 0 type: - integer - 'null' - description: >- Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned in: query name: limit required: false schema: default: 500 description: >- Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned example: 500 maximum: 1000 minimum: 1 type: integer - description: >- 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". in: query name: output_modalities required: false schema: description: >- 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". example: text type: string - description: >- 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. in: query name: sort required: false schema: description: >- 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. enum: - most-popular - newest - top-weekly - pricing-low-to-high - pricing-high-to-low - context-high-to-low - throughput-high-to-low - latency-low-to-high - intelligence-high-to-low - coding-high-to-low - agentic-high-to-low - design-arena-elo-high-to-low example: newest type: string - description: >- Filter models and presets by the named harness's eligibility policy: tool calling is required, and when one of your guardrails sets `enforce_first_party_harness_models`, only the harness vendor's own models remain (OpenAI for codex, Anthropic for claude_code and claude_desktop). When your workspace's Managed Machines policy sets a model list for that harness, only the listed models remain, and a preset remains only while every model it routes to is listed. This filter doesn't apply the harness's ranking, caps or Claude Desktop model ID aliases, so returned IDs stay routable. One of: claude_code, claude_desktop, codex. Omit it to get every model you can use. in: query name: client required: false schema: description: >- Filter models and presets by the named harness's eligibility policy: tool calling is required, and when one of your guardrails sets `enforce_first_party_harness_models`, only the harness vendor's own models remain (OpenAI for codex, Anthropic for claude_code and claude_desktop). When your workspace's Managed Machines policy sets a model list for that harness, only the listed models remain, and a preset remains only while every model it routes to is listed. This filter doesn't apply the harness's ranking, caps or Claude Desktop model ID aliases, so returned IDs stay routable. One of: claude_code, claude_desktop, codex. Omit it to get every model you can use. enum: - claude_code - claude_desktop - codex example: codex type: string responses: '200': content: application/json: example: data: - architecture: input_modalities: - text instruct_type: chatml modality: text->text output_modalities: - text tokenizer: GPT canonical_slug: openai/gpt-4 context_length: 8192 created: 1692901234 default_parameters: null description: >- GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy. endpoints: - /api/v1/chat/completions - /api/v1/completions - /api/v1/messages - /api/v1/responses expiration_date: null id: openai/gpt-4 knowledge_cutoff: null links: details: /api/v1/models/openai/gpt-4/endpoints name: GPT-4 per_request_limits: null pricing: completion: '0.00006' image: '0' prompt: '0.00003' request: '0' supported_parameters: - temperature - top_p - max_tokens supported_voices: null top_provider: context_length: 8192 is_moderated: true max_completion_tokens: 4096 schema: $ref: '#/components/schemas/ModelsListResponse' description: Returns a list of models filtered by user provider preferences '401': content: application/json: example: error: code: 401 message: Missing Authentication header schema: $ref: '#/components/schemas/UnauthorizedResponse' description: Unauthorized - Authentication required or invalid credentials '403': content: application/json: example: error: code: 403 message: Only management keys can perform this operation schema: $ref: '#/components/schemas/ForbiddenResponse' description: Forbidden - Authentication successful but insufficient permissions '404': content: application/json: example: error: code: 404 message: Resource not found schema: $ref: '#/components/schemas/NotFoundResponse' description: Not Found - Resource does not exist '408': content: application/json: example: error: code: 408 message: Operation timed out. Please try again later. schema: $ref: '#/components/schemas/RequestTimeoutResponse' description: Request Timeout - Operation exceeded time limit '409': content: application/json: example: error: code: 409 message: Resource conflict. Please try again later. schema: $ref: '#/components/schemas/ConflictResponse' description: Conflict - Resource conflict or concurrent modification '429': content: application/json: example: error: code: 429 message: Rate limit exceeded schema: $ref: '#/components/schemas/TooManyRequestsResponse' description: Too Many Requests - Rate limit exceeded '500': content: application/json: example: error: code: 500 message: Internal Server Error schema: $ref: '#/components/schemas/InternalServerResponse' description: Internal Server Error - Unexpected server error '503': content: application/json: example: error: code: 503 message: Service temporarily unavailable schema: $ref: '#/components/schemas/ServiceUnavailableResponse' description: Service Unavailable - Service temporarily unavailable security: - bearer: [] components: schemas: ModelsListResponse: description: List of available models example: data: - architecture: input_modalities: - text instruct_type: chatml modality: text->text output_modalities: - text tokenizer: GPT canonical_slug: openai/gpt-4 context_length: 8192 created: 1692901234 default_parameters: null description: >- GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy. expiration_date: null id: openai/gpt-4 knowledge_cutoff: null links: details: /api/v1/models/openai/gpt-4/endpoints name: GPT-4 per_request_limits: null pricing: completion: '0.00006' image: '0' prompt: '0.00003' request: '0' supported_parameters: - temperature - top_p - max_tokens - frequency_penalty - presence_penalty supported_voices: null top_provider: context_length: 8192 is_moderated: true max_completion_tokens: 4096 links: next: /api/v1/models?offset=500&limit=500 total_count: 150 properties: data: $ref: '#/components/schemas/ModelsListResponseData' links: description: Pagination links properties: next: description: >- URL for the next page of results, or null if this is the last page example: /api/v1/models?offset=500&limit=500 type: - string - 'null' required: - next type: object total_count: description: Total number of models matching the query example: 150 type: integer required: - data - total_count - links type: object UnauthorizedResponse: description: Unauthorized - Authentication required or invalid credentials example: error: code: 401 message: Missing Authentication header properties: error: $ref: '#/components/schemas/UnauthorizedResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object ForbiddenResponse: description: Forbidden - Authentication successful but insufficient permissions example: error: code: 403 message: Only management keys can perform this operation properties: error: $ref: '#/components/schemas/ForbiddenResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object NotFoundResponse: description: Not Found - Resource does not exist example: error: code: 404 message: Resource not found properties: error: $ref: '#/components/schemas/NotFoundResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object RequestTimeoutResponse: description: Request Timeout - Operation exceeded time limit example: error: code: 408 message: Operation timed out. Please try again later. properties: error: $ref: '#/components/schemas/RequestTimeoutResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object ConflictResponse: description: Conflict - Resource conflict or concurrent modification example: error: code: 409 message: Resource conflict. Please try again later. properties: error: $ref: '#/components/schemas/ConflictResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object TooManyRequestsResponse: description: Too Many Requests - Rate limit exceeded example: error: code: 429 message: Rate limit exceeded properties: error: $ref: '#/components/schemas/TooManyRequestsResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object InternalServerResponse: description: Internal Server Error - Unexpected server error example: error: code: 500 message: Internal Server Error properties: error: $ref: '#/components/schemas/InternalServerResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object ServiceUnavailableResponse: description: Service Unavailable - Service temporarily unavailable example: error: code: 503 message: Service temporarily unavailable properties: error: $ref: '#/components/schemas/ServiceUnavailableResponseErrorData' openrouter_metadata: additionalProperties: {} type: - object - 'null' user_id: type: - string - 'null' required: - error type: object ModelsListResponseData: description: List of available models example: - architecture: input_modalities: - text instruct_type: chatml modality: text->text output_modalities: - text tokenizer: GPT canonical_slug: openai/gpt-4 context_length: 8192 created: 1692901234 default_parameters: null description: >- GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy. expiration_date: null id: openai/gpt-4 knowledge_cutoff: null links: details: /api/v1/models/openai/gpt-4/endpoints name: GPT-4 per_request_limits: null pricing: completion: '0.00006' image: '0' prompt: '0.00003' request: '0' supported_parameters: - temperature - top_p - max_tokens supported_voices: null top_provider: context_length: 8192 is_moderated: true max_completion_tokens: 4096 items: $ref: '#/components/schemas/Model' type: array UnauthorizedResponseErrorData: description: Error data for UnauthorizedResponse example: code: 401 message: Missing Authentication header properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object ForbiddenResponseErrorData: description: Error data for ForbiddenResponse example: code: 403 message: Only management keys can perform this operation properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object NotFoundResponseErrorData: description: Error data for NotFoundResponse example: code: 404 message: Resource not found properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object RequestTimeoutResponseErrorData: description: Error data for RequestTimeoutResponse example: code: 408 message: Operation timed out. Please try again later. properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object ConflictResponseErrorData: description: Error data for ConflictResponse example: code: 409 message: Resource conflict. Please try again later. properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object TooManyRequestsResponseErrorData: description: Error data for TooManyRequestsResponse example: code: 429 message: Rate limit exceeded properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object InternalServerResponseErrorData: description: Error data for InternalServerResponse example: code: 500 message: Internal Server Error properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object ServiceUnavailableResponseErrorData: description: Error data for ServiceUnavailableResponse example: code: 503 message: Service temporarily unavailable properties: code: type: integer message: type: string metadata: additionalProperties: {} type: - object - 'null' required: - code - message type: object Model: description: Information about an AI model available on OpenRouter example: architecture: input_modalities: - text instruct_type: chatml modality: text->text output_modalities: - text tokenizer: GPT canonical_slug: openai/gpt-4 context_length: 8192 created: 1692901234 default_parameters: null description: >- GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy. expiration_date: null id: openai/gpt-4 knowledge_cutoff: null links: details: /api/v1/models/openai/gpt-5.4/endpoints name: GPT-4 per_request_limits: null pricing: completion: '0.00006' image: '0' prompt: '0.00003' request: '0' reasoning: default_effort: medium default_enabled: true mandatory: false supported_efforts: - high - medium - low - minimal supported_parameters: - temperature - top_p - max_tokens supported_voices: null top_provider: context_length: 8192 is_moderated: true max_completion_tokens: 4096 properties: alias_target: $ref: '#/components/schemas/ModelAliasTarget' architecture: $ref: '#/components/schemas/ModelArchitecture' benchmarks: $ref: '#/components/schemas/ModelBenchmarks' canonical_slug: description: Canonical slug for the model example: openai/gpt-4 type: string context_length: description: Maximum context length in tokens example: 8192 type: - integer - 'null' created: description: Unix timestamp of when the model was created example: 1692901234 type: integer default_parameters: $ref: '#/components/schemas/DefaultParameters' description: description: Description of the model example: >- GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy. type: string endpoints: description: >- Request API paths that serve this model, derived from the same modality and adapter rules the routers use. A model served only through an alpha surface lists only that path. example: - /api/v1/chat/completions - /api/v1/completions - /api/v1/messages - /api/v1/responses items: type: string type: array expiration_date: description: >- The date after which the model may be removed. ISO 8601 date string (YYYY-MM-DD) or null if no expiration. example: '2025-06-01' type: - string - 'null' hugging_face_id: description: Hugging Face model identifier, if applicable example: microsoft/DialoGPT-medium type: - string - 'null' id: description: Unique identifier for the model example: openai/gpt-4 type: string knowledge_cutoff: description: >- The date up to which the model was trained on data. ISO 8601 date string (YYYY-MM-DD) or null if unknown. example: '2024-10-01' type: - string - 'null' links: $ref: '#/components/schemas/ModelLinks' name: description: Display name of the model example: GPT-4 type: string per_request_limits: $ref: '#/components/schemas/PerRequestLimits' pricing: $ref: '#/components/schemas/PublicPricing' reasoning: $ref: '#/components/schemas/ModelReasoning' supported_parameters: description: List of supported parameters for this model items: $ref: '#/components/schemas/Parameter' type: array supported_voices: description: >- List of supported voice identifiers for TTS models. Null for non-TTS models. example: null items: type: string type: - array - 'null' top_provider: $ref: '#/components/schemas/TopProviderInfo' required: - id - canonical_slug - name - created - pricing - context_length - architecture - top_provider - per_request_limits - supported_parameters - default_parameters - supported_voices - links - endpoints type: object ModelAliasTarget: description: Concrete model targeted by this tilde-latest alias, when applicable example: name: Claude Sonnet 4.5 slug: anthropic/claude-sonnet-4.5 properties: name: description: Human-readable name of the concrete model targeted by this alias type: string slug: description: >- Routable model ID of the concrete target, matching that model row's id type: string required: - slug - name type: object ModelArchitecture: description: Model architecture information example: input_modalities: - text instruct_type: chatml modality: text->text output_modalities: - text tokenizer: GPT properties: input_modalities: description: Supported input modalities items: $ref: '#/components/schemas/InputModality' type: array instruct_type: $ref: '#/components/schemas/InstructType' modality: description: Primary modality of the model example: text->text type: - string - 'null' output_modalities: description: Supported output modalities items: $ref: '#/components/schemas/OutputModality' type: array tokenizer: $ref: '#/components/schemas/ModelGroup' required: - modality - input_modalities - output_modalities type: object ModelBenchmarks: description: >- Third-party benchmark rankings for this model. Omitted when no benchmark data is available. example: artificial_analysis: agentic_index: 55.8 coding_index: 63.2 intelligence_index: 71.4 design_arena: - arena: models category: website elo: 1385.2 rank: 5 win_rate: 62.5 properties: artificial_analysis: $ref: '#/components/schemas/AABenchmarkEntry' design_arena: description: Design Arena ELO rankings across arena+category pairs. example: - arena: models category: website elo: 1385.2 rank: 5 win_rate: 62.5 items: $ref: '#/components/schemas/DABenchmarkEntry' type: array required: - design_arena type: object DefaultParameters: additionalProperties: false description: Default parameters for this model example: frequency_penalty: 0 presence_penalty: 0 repetition_penalty: 1 temperature: 0.7 top_k: 0 top_p: 0.9 properties: frequency_penalty: format: double type: - number - 'null' presence_penalty: format: double type: - number - 'null' repetition_penalty: format: double type: - number - 'null' temperature: format: double type: - number - 'null' top_k: type: - integer - 'null' top_p: format: double type: - number - 'null' type: - object - 'null' ModelLinks: description: Related API endpoints and resources for this model. example: details: /api/v1/models/openai/gpt-5.4/endpoints properties: details: description: URL for the model details/endpoints API example: /api/v1/models/openai/gpt-5.4/endpoints type: string required: - details type: object PerRequestLimits: description: Per-request token limits example: completion_tokens: 1000 prompt_tokens: 1000 properties: completion_tokens: description: Maximum completion tokens per request example: 1000 type: number prompt_tokens: description: Maximum prompt tokens per request example: 1000 type: number required: - prompt_tokens - completion_tokens type: - object - 'null' PublicPricing: description: Pricing information for the model example: completion: '0.00006' image: '0' prompt: '0.00003' request: '0' properties: audio: description: Price in USD per audio input token type: string audio_output: description: Price in USD per audio output token type: string completion: description: Price in USD per token for completion (output) generation type: string discount: description: >- Fractional discount applied to this endpoint's pricing; the price is multiplied by (1 - discount) (0 = no discount, 1 = free) format: double type: number image: description: Price in USD per input image type: string image_output: description: Price in USD per output image type: string image_token: description: Price in USD per image token type: string input_audio_cache: description: Price in USD per cached audio input token type: string input_cache_read: description: Price in USD per cached input token (read) type: string input_cache_write: description: >- Price per cache-write token, in USD per token. For providers with multiple cache TTLs (e.g. Anthropic), this is the default (5-minute) cache-write rate. type: string input_cache_write_1h: description: >- Price per 1-hour cache-write token, in USD per token. Only present for providers that price an extended (1-hour) cache TTL separately, such as Anthropic. type: string internal_reasoning: description: Price in USD per internal reasoning token type: string overrides: description: >- Conditional overrides of the base pricing (e.g. long-context or time-based pricing). An entry applies when all of its condition fields (e.g. min_prompt_tokens, or the utc_start/utc_end time window) match the request; among applicable entries, later entries win per key; price keys absent from an entry inherit the base price. The top-level pricing keys always reflect the price that applies under default conditions. items: $ref: '#/components/schemas/PricingOverride' type: array prompt: description: Price in USD per token for prompt (input) processing type: string request: description: Price in USD per request type: string web_search: description: Price in USD per web search type: string required: - prompt - completion type: object ModelReasoning: description: >- Reasoning effort configuration. Omitted for non-reasoning models and dynamic router models. example: default_effort: medium default_enabled: true mandatory: false supported_efforts: - high - medium - low - minimal properties: default_effort: allOf: - $ref: '#/components/schemas/ReasoningEffort' - description: >- Default reasoning effort when the client enables reasoning without specifying effort. Maps to `reasoning.effort` in chat requests. When `"none"`, prefer omitting effort unless the user explicitly disables reasoning. default_enabled: description: >- Default reasoning enabled state when the client does not set `reasoning.enabled`. type: boolean mandatory: description: >- When true, reasoning cannot be disabled and effort "none" is rejected. type: boolean supported_efforts: description: >- Allowed reasoning effort values for this model, in descending effort order (highest first). Null means no allowlist — all gateway effort values are accepted. items: $ref: '#/components/schemas/ReasoningEffort' type: - array - 'null' supports_max_tokens: description: >- Present and `true` when the model accepts `reasoning.max_tokens` in requests (Anthropic-style) instead of or in addition to `reasoning.effort`. Omitted otherwise. type: boolean required: - mandatory type: object Parameter: enum: - temperature - top_p - top_k - min_p - top_a - frequency_penalty - presence_penalty - repetition_penalty - max_tokens - max_completion_tokens - logit_bias - logprobs - top_logprobs - prediction - seed - response_format - structured_outputs - stop - tools - tool_choice - parallel_tool_calls - include_reasoning - reasoning - reasoning_effort - web_search_options - verbosity example: temperature type: string TopProviderInfo: description: Information about the top provider for this model example: context_length: 8192 is_moderated: true max_completion_tokens: 4096 properties: context_length: description: Context length from the top provider example: 8192 type: - integer - 'null' is_moderated: description: Whether the top provider moderates content example: true type: boolean max_completion_tokens: description: >- Maximum completion tokens from the top provider. Input and output tokens share the context window, so the effective maximum output for a request is further limited by the context remaining after input tokens. example: 4096 type: - integer - 'null' required: - is_moderated type: object InputModality: enum: - text - image - file - audio - video example: text type: string InstructType: description: Instruction format type enum: - none - airoboros - alpaca - alpaca-modif - chatml - claude - code-llama - gemma - llama2 - llama3 - mistral - nemotron - neural - openchat - phi3 - rwkv - vicuna - zephyr - deepseek-r1 - deepseek-v3.1 - qwq - qwen3 - null example: chatml type: - string - 'null' OutputModality: enum: - text - image - embeddings - audio - video - rerank - decisions - speech - transcription example: text type: string ModelGroup: description: Tokenizer type used by the model enum: - Router - Media - Other - GPT - Claude - Gemini - Gemma - Grok - Cohere - Nova - Qwen - Yi - DeepSeek - Mistral - Llama2 - Llama3 - Llama4 - PaLM - RWKV - Qwen3 example: GPT type: string AABenchmarkEntry: description: Artificial Analysis benchmark index scores. example: agentic_index: 55.8 coding_index: 63.2 intelligence_index: 71.4 properties: agentic_index: description: Artificial Analysis Agentic Index score example: 55.8 format: double type: - number - 'null' coding_index: description: Artificial Analysis Coding Index score example: 63.2 format: double type: - number - 'null' intelligence_index: description: Artificial Analysis Intelligence Index score example: 71.4 format: double type: - number - 'null' required: - intelligence_index - coding_index - agentic_index type: object DABenchmarkEntry: description: A single Design Arena benchmark entry for a specific arena+category example: arena: models category: website elo: 1385.2 rank: 5 win_rate: 62.5 properties: arena: description: Arena type (e.g. models, builders, agents) example: models type: string category: description: Category within the arena (e.g. website, gamedev, uicomponent) example: website type: string elo: description: ELO rating from head-to-head arena battles example: 1385.2 format: double type: number rank: description: >- Rank position within this arena+category among models available on OpenRouter (1 = highest ELO) example: 5 type: integer win_rate: description: Win rate percentage in arena battles example: 62.5 format: double type: number required: - arena - category - elo - win_rate - rank type: object PricingOverride: description: >- A conditional override of the base pricing. An entry applies only when all of its condition fields (e.g. min_prompt_tokens, or the utc_start/utc_end time window) match the request; among applicable entries, later entries win per price key; price keys absent from an entry inherit the base price. example: completion: '0.00002' min_prompt_tokens: 200000 prompt: '0.000005' properties: audio: description: Overridden price in USD per audio input token type: string completion: description: Overridden price in USD per token for completion (output) generation type: string input_audio_cache: description: Overridden price in USD per cached audio input token type: string input_cache_read: description: Overridden price in USD per cached input token (read) type: string input_cache_write: description: Overridden price in USD per cache-write token type: string input_cache_write_1h: description: Overridden price in USD per 1-hour cache-write token type: string min_prompt_tokens: description: >- Condition: the entry applies when the total prompt tokens of a request are strictly greater than this threshold format: double type: number prompt: description: Overridden price in USD per token for prompt (input) processing type: string utc_days: description: >- Condition: UTC weekdays the entry applies on, evaluated at the request instant. Scopes the utc_start/utc_end window (or, without a window, the whole UTC day) to the listed days. Absent means every day. items: enum: - monday - tuesday - wednesday - thursday - friday - saturday - sunday type: string minItems: 1 type: array utc_end: description: >- Condition: exclusive end of a daily UTC time window as an HHMM clock number (e.g. 400 = 04:00) format: double type: number utc_start: description: >- Condition: inclusive start of a daily UTC time window as an HHMM clock number (e.g. 100 = 01:00, 1030 = 10:30). The entry applies while the current UTC time is inside the half-open window [utc_start, utc_end), which may wrap past midnight (utc_start > utc_end). format: double type: number type: object ReasoningEffort: enum: - max - xhigh - high - medium - low - minimal - none - null example: medium type: - string - 'null' securitySchemes: apiKey: description: API key as bearer token in Authorization header scheme: bearer type: http bearer: description: API key as bearer token in Authorization header scheme: bearer type: http ````