# List Models

List every model available to the key.

`GET /api/v1/models`

## Overview

Returns only models routed to the calling key's workspace and allowed by that key's model policy. Each item includes the OpenAI-style id and object fields plus CAPI metadata for provider, modality, capabilities, and price. Use modality and provider query parameters to filter the list.

## Parameters

- `modality` (string): Filter by modality, e.g. video.
- `provider` (string): Filter by provider name.

## Example

```bash
curl https://capi.minapp.xin/api/v1/models?modality=video \
  -H "Authorization: Bearer YOUR_API_TOKEN"
```

## Response

```json
{
  "object": "list",
  "group": "default",
  "source": "relay",
  "data": [
    {
      "id": "kling-v3-turbo-text-to-video",
      "object": "model",
      "owned_by": "default",
      "family": "kling",
      "provider": "Kling",
      "modality": "video",
      "capabilities": ["Text to video", "Image to video"],
      "price": { "amount": 0.07, "unit": "second", "currency": "USD" }
    }
  ]
}
```