Get Models

Return available models and metadata.

GET/v1/models

Request Example

bash
curl https://api.therouter.ai/v1/models
  -H "Authorization: Bearer $THEROUTER_API_KEY"

Response

json
{
  "data": [
    {
      "id": "openai/gpt-4o",
      "object": "model",
      "created": 1700000000,
      "owned_by": "openai",
      "name": "GPT-4o",
      "description": "General-purpose multimodal model",
      "context_length": 128000,
      "pricing": {
        "prompt": "0.000005",
        "completion": "0.000015",
        "request": "0",
        "image": "0"
      },
      "architecture": {
        "modality": "text+image->text",
        "input_modalities": ["text", "image"],
        "output_modalities": ["text"],
        "tokenizer": "cl100k_base"
      },
      "top_provider": {
        "context_length": 128000,
        "max_completion_tokens": 16384,
        "is_moderated": true
      },
      "supported_parameters": ["temperature", "top_p", "stop", "tools"],
      "per_request_limits": null
    }
  ]
}
Notes
This endpoint does not support documented provider or architecturequery filters.