Lists Models

GET 
/models

Lists the currently available models, and provides metadata about each one, such as its display name, context window, output limit, supported input/output modalities, supported effort levels, and per-protocol API capabilities. Check Models & Pricing for our currently supported models.

Responses

200

OK, returns A list of models

application/json

Schema

Schema

object stringrequired

Possible values: [list]

The object type, which is always list.

data

object[]

required

The list of model objects.

Array [

id stringrequired

The model identifier, which can be referenced in the API endpoints.

object stringrequired

Possible values: [model]

The object type, which is always "model".

owned_by stringrequired

The organization that owns the model.

name string

The display name of the model, for use in model pickers and model discovery tools.

context_window integer

The total token capacity of the context window, counting both input and output tokens.

max_output_tokens integer

The maximum number of output tokens the server allows in a single response, i.e. the maximum accepted value of max_tokens.

input_modalities string[]

Possible values: [text, image]

The input types the model accepts.

output_modalities string[]

Possible values: [text]

The media types the model can generate.

effort

object

The effort levels available when thinking mode is enabled.

supported_levels string[]required

The effort levels the model supports when thinking mode is enabled, in the recommended display order. These are the values accepted by the reasoning_effort parameter; none, which turns thinking mode off, is not included.

default_level string

The effort level the server uses when thinking mode is enabled and the request does not specify one. Always one of supported_levels. Only present when the server defines a default for the model.

api_capabilities

object

Model behavior declared per API protocol.

anthropic_messages

object

Capabilities that apply when the model is used through the Anthropic Messages API.

system_prompt_update stringrequired

Possible values: [leading-only, in-history]

How the model picks up an updated system prompt during a conversation.

• leading-only: only the system prompt at the start of the conversation takes effect. To change the system prompt, modify that leading system prompt; system messages appearing later in the history are not treated as system prompt updates.
• in-history: a system message may be appended to the conversation history. The latest system message in the history provides the complete effective system prompt and replaces all earlier ones.

]

Example (from schema)

{
  "object": "list",
  "data": [
    {
      "id": "string",
      "object": "model",
      "owned_by": "string",
      "name": "string",
      "context_window": 0,
      "max_output_tokens": 0,
      "input_modalities": [
        "text"
      ],
      "output_modalities": [
        "text"
      ],
      "effort": {
        "supported_levels": [
          "string"
        ],
        "default_level": "string"
      },
      "api_capabilities": {
        "anthropic_messages": {
          "system_prompt_update": "leading-only"
        }
      }
    }
  ]
}

Example

{
  "object": "list",
  "data": [
    {
      "id": "deepseek-flash",
      "object": "model",
      "owned_by": "deepseek",
      "name": "DeepSeek-V4.1-Flash",
      "context_window": 1048576,
      "max_output_tokens": 393216,
      "input_modalities": ["text", "image"],
      "output_modalities": ["text"],
      "effort": {
        "supported_levels": ["low", "high", "max"],
        "default_level": "high"
      },
      "api_capabilities": {
        "anthropic_messages": {
          "system_prompt_update": "in-history"
        }
      }
    },
    {
      "id": "deepseek-v4-pro",
      "object": "model",
      "owned_by": "deepseek",
      "name": "DeepSeek-V4-Pro",
      "context_window": 1048576,
      "max_output_tokens": 393216,
      "input_modalities": ["text"],
      "output_modalities": ["text"],
      "effort": {
        "supported_levels": ["low", "high", "max"],
        "default_level": "high"
      },
      "api_capabilities": {
        "anthropic_messages": {
          "system_prompt_update": "leading-only"
        }
      }
    }
  ]
}

Loading...