Sign in
Models

List models filtered by user provider preferences, privacy settings, and guardrails

List models filtered by user provider preferences, privacy settings, and guardrails. If requesting through eu.openrouter.ai/api/v1/... the results will be filtered to models that satisfy EU in-region routing.

get/models/user

Query parameters

offsetinteger nullable

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

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

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

Response

Returns a list of models filtered by user provider preferences

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