Models

List all models and their properties

Changed on
get/models

Request

  • Base URL: https://openrouter.ai/api/v1
  • URL: https://openrouter.ai/api/v1/models
  • Auth: HTTP bearer

Query parameters

offsetinteger nullable

Number of records to skip for pagination. When both offset and limit are omitted, the full list is returned

limitinteger

Maximum number of records to return (max 1000). When both offset and limit are omitted, the full list is returned

Example:500
category'programming' | 'roleplay' | 'marketing' | 'marketing/seo' | 'technology' | 'science' | 'translation' | 'legal' | 'finance' | 'health' | 'trivia' | 'academia'

Filter models by use case category

Example:programming
supported_parametersstring

Filter models by supported parameter (comma-separated)

Example:temperature
output_modalitiesstring

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
sort'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'

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.

Example:newest
use_rssstring

Return results as RSS feed

Example:true
use_rss_chat_linksstring

Use chat links in RSS feed items

Example:true
qstring

Free-text search by model name or slug.

Example:gpt-4
input_modalitiesstring

Filter models by input modality. Comma-separated list of: text, image, audio, file.

Example:text,image
contextinteger

Minimum context length (tokens). Models with smaller context are excluded.

Example:128000
min_pricenumber nullable

Minimum prompt price in $/M tokens.

max_pricenumber nullable

Maximum prompt price in $/M tokens.

Example:10
archstring

Filter models by architecture/model family (e.g. GPT, Claude, Gemini, Llama).

Example:GPT
model_authorsstring

Filter models by the organization that created the model. Comma-separated list of author slugs.

Example:openai,anthropic
providersstring

Filter models by hosting provider. Comma-separated list of provider names.

Example:OpenAI,Anthropic
distillable'true' | 'false'

Filter by distillation capability. "true" returns only distillable models, "false" excludes them.

Example:true
zdr'true'

When set to "true", return only models with zero data retention endpoints.

Example:true
region'eu' | 'us'

Filter to models with endpoints in the given data region ("eu" or "us").

Example:eu
min_output_pricenumber nullable

Minimum completion (output) price in $/M tokens.

max_output_pricenumber nullable

Maximum completion (output) price in $/M tokens.

Example:10
min_age_daysinteger nullable

Minimum model age in days since its creation date.

max_age_daysinteger nullable

Maximum model age in days since its creation date.

Example:90
min_intelligence_indexnumber nullable

Minimum Artificial Analysis intelligence index.

Example:50
max_intelligence_indexnumber nullable

Maximum Artificial Analysis intelligence index.

Example:100
min_coding_indexnumber nullable

Minimum Artificial Analysis coding index.

Example:50
max_coding_indexnumber nullable

Maximum Artificial Analysis coding index.

Example:100
min_agentic_indexnumber nullable

Minimum Artificial Analysis agentic index.

Example:50
max_agentic_indexnumber nullable

Maximum Artificial Analysis agentic index.

Example:100
min_tool_success_ratenumber nullable

Minimum tool-calling success rate, as a fraction in [0, 1] (e.g. 0.9 = 90% of requests finishing with a tool_calls finish reason).

Example:0.9
max_tool_success_ratenumber nullable

Maximum tool-calling success rate, as a fraction in [0, 1].

Example:1

Response

Returns a list of models or RSS feed

total_countinteger required

Total number of models matching the query

Example response

{
  "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
}

Changes

  • 2de027b6dfcdRevision changes
    • warning

      added the new decisions enum value to the //// response property for the response status

  • ad4e1cd6fc96Revision changes
    • info

      added the optional property ///// to the response with the status