> ## Documentation Index
> Fetch the complete documentation index at: https://docs.routerbase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Models API

> List and query available models and their pricing.

## List Models

```
GET https://routerbase.com/api/v1/models
```

### Query Parameters

<ParamField query="task" type="string[]">
  Filter by modality. Repeat for OR logic. Options: `video`, `image`, `audio`, `chat`.
</ParamField>

<ParamField query="provider" type="string[]">
  Filter by provider (real vendor). Repeat for OR logic. Options: `Google`, `ByteDance`, `Kuaishou`, `Alibaba`, `Black Forest Labs`, `Ideogram`, `OpenAI`, `Midjourney`, `xAI`, `Runway`, `MiniMax`, `Suno`, `ElevenLabs`, `Recraft`, `Topaz`, `Luma`, `Anthropic`, `Infinitalk`.
</ParamField>

<ParamField query="search" type="string">
  Full-text search across model names and descriptions.
</ParamField>

<ParamField query="page" type="number">
  Page number (1-indexed). Default: `1`.
</ParamField>

<ParamField query="per_page" type="number">
  Results per page. Default: `20`.
</ParamField>

### Response

```json theme={null}
{
  "data": [
    {
      "id": "video_generate.kling_2_6",
      "name": "Kuaishou / kling/2.6-text-to-video",
      "provider": "Kuaishou",
      "modality": "video",
      "description": "Kuaishou Kling 2 6 (video generate).",
      "tags": ["video", "generation", "text-to-video"],
      "is_popular": false,
      "is_active": true,
      "created_at": "2024-01-01T00:00:00Z",
      "updated_at": "2024-01-01T00:00:00Z"
    }
  ],
  "page": 1,
  "per_page": 20,
  "total": 23,
  "total_pages": 2
}
```

### Example

```bash theme={null}
# List all video models
curl "https://routerbase.com/api/v1/models?task=video" \
  -H "Authorization: Bearer sk-rb-xxxxxxxxxxxx"

# Search for Kling models
curl "https://routerbase.com/api/v1/models?search=kling" \
  -H "Authorization: Bearer sk-rb-xxxxxxxxxxxx"
```

***

## Get Model Details

```
GET https://routerbase.com/api/v1/models/{model_id}
```

Returns metadata for a single model.

```bash theme={null}
curl https://routerbase.com/api/v1/models/video_generate.kling_2_6 \
  -H "Authorization: Bearer sk-rb-xxxxxxxxxxxx"
```

***

## Get Popular Models

```
GET https://routerbase.com/api/v1/models/popular
```

Returns a curated list of featured models.

***

## Get Model Pricing

```
GET https://routerbase.com/api/v1/models/{model_id}/pricing
```

Returns pricing details for a specific model.

***

## List All Pricing

```
GET https://routerbase.com/api/v1/pricing
```

Returns pricing for all active models in one call.