Fetch Models

GET 
/v1/models

Fetch all available models or use one or more filters

Request

Query Parameters

type string

Possible values: [llm, vision, embedding, image, voice, moderation, coding, free]

Filter by type of model.

Examples:

llm

Filter by type 'llm' language models

Example: llm

voice

Filter by type 'voice' (tts and stt)

Example: voice

subtype string

Possible values: [chat, fill-mask, question-answering, tts, stt, multimodal]

Filter by subtype of model.

Examples:

chat

Filter by subtype 'chat'

Example: chat

provider string

Filter by provider of the model.

Examples:

openrouter

Filter by provider 'openrouter'

Example: openrouter

combination string

Filter by a combination of provider and subtype.

Examples:

providerAndSubtype

Filter by provider 'openrouter' and subtype 'chat'

Example: provider=openrouter&subtype=chat

enabled integer

Possible values: [1, 0]

only show enabled chat models

Examples:

enabledAndSubtype

only show enabled chat models

Example: enabled=1&subtype=chat

voices parameter

Retrieve a complete list of available voices. just use /v1/models?voices do not include any other value

Examples:

voices

Display list of voices for tts voice models, just use /v1/models?voices'

Example: voices

restrictions string

Retrieve a complete list of available Country Restrictions. just use /v1/models?restrictions do not include any other value

Examples:

restrictions

Display list of different provider supported countries lists, just use /v1/models?restrictions'

Example: restrictions

Responses

200

Models or voices list depending on query parameter used.

application/json

Schema

Schema

oneOf
ModelResponse
object string
Type of the list
data object[]
Array [
enabled booleanrequired
Whether Model is enabled
type stringrequired
Possible values: [llm, vision, embedding, image, voice, moderation, code]
Type of the model
subtype string
Subtype of the model
provider stringrequired
Provider of the model
model stringrequired
The base model name
route stringrequired
Provider specific identifier
description string
Description of the Model
max_tokens integerrequired
Max cumulative tokens supported by the model
max_response_tokens integerrequired
Max tokens that this model can return in the response
req_price string
Price for request - per unit. If not present, price only provided by the provider in query response
res_price string
Price for response - per unit. If not present, price only provided by the provider in query response
price_unit string
Price unit, the number of price_type per price
price_type string
Possible values: [token, char, request, tokens, image, minute, characters, character, provider]
Type of the price
avg_cost string
Average cost of the model, tracking actual usage. This is the average cost per 1000 characters
latency stringrequired
Average latency by combined prompt/response size, in the format: 2000/4000/8000/16000/32000/Average_Latency_per_1000_characters
available booleanrequired
Availability status of the model
query_count stringrequired
Total count of queries for this model
]
VoiceModelResponse
object string
Type of the response object, always a list.
data object[]
Array [
provider string
Provider of the voice model.
model string
Model identifier.
voice string
Unique identifier for the voice.
name string
Name of the voice.
description string
Description of the voice characteristics.
]
RestrictionsResponse
object string
Type of the response object, always a list.
data object[]
Array [
restrict_id integer
Unique identifier for the restrict table.
name string
Name or description, usually the provider name.
countries string
JSON string of supported countries.
]

Example (from schema)

{
  "object": "list",
  "data": [
    {
      "enabled": 1,
      "type": "llm",
      "subtype": null,
      "provider": "openrouter",
      "model": "nous-capybara-7b",
      "route": "nousresearch/nous-capybara-7b",
      "description": "The Capybara series is a collection of datasets and models...",
      "max_tokens": 4096,
      "max_response_tokens": 4096,
      "req_price": "0.0000001800000000",
      "res_price": "0.0000001800000000",
      "price_type": "token",
      "price_unit": "1.00",
      "avg_cost": "0.0000912966",
      "latency": "1162/2145/6245/8234/18456/8162",
      "available": 1,
      "query_count": "310,000"
    },
    {
      "...": "Additional models not shown..."
    }
  ]
}

Models

Example response for a models request

{
  "object": "list",
  "data": [
    {
      "enabled": 1,
      "type": "llm",
      "subtype": null,
      "provider": "openrouter",
      "model": "nous-capybara-7b",
      "route": "nousresearch/nous-capybara-7b",
      "description": "The Capybara series...",
      "max_tokens": 4096,
      "max_response_tokens": 4096,
      "req_price": "0.0000001800000000",
      "res_price": "0.0000001800000000",
      "price_type": "token",
      "price_unit": "1.00",
      "avg_cost": "0.0000912966",
      "latency": "1162/na/na/na/na/1162",
      "available": 1,
      "query_count": "310"
    },
    {
      "...": "Additional models not shown..."
    }
  ]
}

Voices

Example voice models response for a models query with the '?voices' parameter

{
  "object": "list",
  "data": [
    {
      "provider": "elevenlabs",
      "model": "eleven_multilingual_v2",
      "voice": "21m00Tcm4TlvDq8ikWAM",
      "name": "Rachel",
      "description": "accent: american, description: calm, age: young, gender: female, use case: narration"
    },
    {
      "provider": "elevenlabs",
      "model": "eleven_turbo_v2",
      "voice": "zrHiDhphv9ZnVXBqCLjz",
      "name": "Mimi",
      "description": "accent: english-swedish, description: childish, age: young, gender: female, use case: animation"
    },
    {
      "...": "Additional models not shown..."
    }
  ]
}

Restrictions

Example country restrictions response for a models query with the '?restrictions' parameter

{
  "object": "list",
  "data": [
    {
      "restrict_id": 2,
      "name": "openai",
      "countries": "{\"countries\":[{\"name\":\"Albania\",\"alpha-2\":\"AL\"},{\"name\":\"Algeria\",\"alpha-2\":\"DZ\"},{\"name\":\"Afghanistan\",\"alpha-2\":\"AF\"}]}"
    },
    {
      "restrict_id": 3,
      "name": "anthropic",
      "countries": "{\"countries\":[{\"name\":\"Germany\",\"alpha-2\":\"DE\"},{\"name\":\"France\",\"alpha-2\":\"FR\"},{\"name\":\"Spain\",\"alpha-2\":\"ES\"}]}"
    },
    {
      "...": "Additional restrictions not shown..."
    }
  ]
}

Loading...