Skip to main content
GET
/
v1
/
models
List Models
curl --request GET \
  --url https://api.example.com/v1/models
{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "provider": "<string>",
      "created_at": "<string>",
      "display_name": "<string>",
      "description": "<string>",
      "version": "<string>",
      "capabilities": {
        "text": true,
        "vision": true,
        "audio": true,
        "image_generation": true,
        "tools": true,
        "structured_output": true,
        "streaming": true,
        "thinking": true,
        "input_token_limit": 123,
        "output_token_limit": 123
      },
      "defaults": {
        "temperature": 123,
        "max_output_tokens": 123,
        "top_p": 123,
        "top_k": 123
      },
      "provider_declared_generation_methods": [
        "<string>"
      ],
      "provider_info": {}
    }
  ]
}

​
Method

client.models.list()
Retrieve the complete list of models available to your organization, including models from OpenAI, Anthropic, Google, xAI, Mistral, Groq, Fireworks, and DeepSeek.

​
Parameters

This endpoint does not require any parameters.

​
Response

​
object
string
The object type, always "list".
​
data
array
required
List of available models.

​
Example

const response = await client.models.list();

// List all available models
console.log(`Found ${response.data.length} models`);

// Filter by provider
const openaiModels = response.data.filter(
  model => model.provider === "openai"
);

// Find models with specific capabilities
const visionModels = response.data.filter(
  model => model.capabilities?.vision === true
);

// Get models with tool calling support
const toolModels = response.data.filter(
  model => model.capabilities?.tools === true
);

console.log("Vision-capable models:", visionModels.map(m => m.id));

​
Response Example

{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-4",
      "provider": "openai",
      "created_at": "2023-06-27T00:00:00Z",
      "display_name": "GPT-4",
      "description": "Most capable GPT-4 model for complex tasks",
      "version": "gpt-4-0613",
      "capabilities": {
        "text": true,
        "vision": false,
        "audio": false,
        "image_generation": false,
        "tools": true,
        "structured_output": true,
        "streaming": true,
        "thinking": false,
        "input_token_limit": 8192,
        "output_token_limit": 4096
      },
      "defaults": {
        "temperature": 1.0,
        "max_output_tokens": 4096,
        "top_p": 1.0
      }
    },
    {
      "id": "anthropic/claude-3-5-sonnet-20241022",
      "provider": "anthropic",
      "created_at": "2024-10-22T00:00:00Z",
      "display_name": "Claude 3.5 Sonnet",
      "description": "Most intelligent Claude model with vision capabilities",
      "version": "claude-3-5-sonnet-20241022",
      "capabilities": {
        "text": true,
        "vision": true,
        "audio": false,
        "image_generation": false,
        "tools": true,
        "structured_output": true,
        "streaming": true,
        "thinking": false,
        "input_token_limit": 200000,
        "output_token_limit": 8192
      },
      "defaults": {
        "temperature": 1.0,
        "max_output_tokens": 8192
      }
    }
  ]
}

Build docs developers (and LLMs) love

Get started for freeTalk to us