Models - Python SDK

Models method reference

(models)

Overview

Model information endpoints

Available Operations

  • count - Get total count of available models
  • list - List all models and their properties
  • list_for_user - List models filtered by user provider preferences

count

Get total count of available models

Example Usage

1from openrouter import OpenRouter
2import os
3
4with OpenRouter(
5 api_key=os.getenv("OPENROUTER_API_KEY", ""),
6) as open_router:
7
8 res = open_router.models.count()
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescription
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

components.ModelsCountResponse

Errors

Error TypeStatus CodeContent Type
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*

list

List all models and their properties

Example Usage

1from openrouter import OpenRouter
2import os
3
4with OpenRouter(
5 api_key=os.getenv("OPENROUTER_API_KEY", ""),
6) as open_router:
7
8 res = open_router.models.list()
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescription
categoryOptional[str]N/A
supported_parametersOptional[str]N/A
use_rssOptional[str]N/A
use_rss_chat_linksOptional[str]N/A
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

operations.GetModelsResponse

Errors

Error TypeStatus CodeContent Type
errors.BadRequestResponseError400application/json
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*

list_for_user

List models filtered by user provider preferences

Example Usage

1from openrouter import OpenRouter, operations
2import os
3
4with OpenRouter() as open_router:
5
6 res = open_router.models.list_for_user(security=operations.ListModelsUserSecurity(
7 bearer=os.getenv("OPENROUTER_BEARER", ""),
8 ))
9
10 # Handle response
11 print(res)

Parameters

ParameterTypeRequiredDescription
securityoperations.ListModelsUserSecurity✔️The security requirements to use for the request.
retriesOptional[utils.RetryConfig]Configuration to override the default retry behavior of the client.

Response

components.ModelsListResponse

Errors

Error TypeStatus CodeContent Type
errors.UnauthorizedResponseError401application/json
errors.InternalServerResponseError500application/json
errors.OpenRouterDefaultError4XX, 5XX*/*