List available models

1 min readEdit this page
GET
/v1/models

Returns all models available across configured providers. Supports optional query filters for provider, model ID substring, and modality.

Query Parameters

provider?string

Filter by provider name (exact match against the model's providers array).

id?string

Filter by model ID (case-insensitive substring match).

input_modality?string

Filter by supported input modality (e.g. text, image).

output_modality?string

Filter by supported output modality.

Response Body

application/json

curl -X GET "https://example.com/v1/models"
{  "data": [    {      "capabilities": [        "string"      ],      "description": "string",      "id": "string",      "input_modalities": [        "string"      ],      "max_input_tokens": 0,      "max_output_tokens": 0,      "name": "string",      "output_modalities": [        "string"      ],      "pricing": {        "context_tiers": [          {            "above_input_tokens": 0,            "input_tokens": {              "cache_read": 0,              "cache_write": 0,              "no_cache": 0            },            "output_tokens": {              "audio": 0,              "image": 0,              "reasoning": 0,              "text": 0            }          }        ],        "input_tokens": {          "cache_read": 0,          "cache_write": 0,          "no_cache": 0        },        "output_tokens": {          "audio": 0,          "image": 0,          "reasoning": 0,          "text": 0        }      },      "providers": {        "total_online": 0      }    }  ]}

How is this guide?