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

# Models

> 사용 가능한 모델 목록 조회

# GET /v1/models

사용 가능한 모든 모델과 Auto Tier 목록을 반환합니다. 인증 불필요.

## 응답

```json 200 - 성공 theme={null}
{
  "object": "list",
  "data": [
    {
      "id": "kr/gpt54",
      "object": "model",
      "created": 1700000000,
      "owned_by": "k-router",
      "name": "GPT-5.4",
      "provider": "openai",
      "pricing": {
        "input_per_1m_tokens": 2.50,
        "output_per_1m_tokens": 15.00,
        "currency": "USD"
      },
      "context_length": 256000
    },
    {
      "id": "auto-smart",
      "object": "model",
      "created": 1700000000,
      "owned_by": "k-router",
      "name": "auto-smart",
      "provider": "k-router",
      "context_length": 128000
    }
  ]
}
```

## 응답 필드

| 필드               | 타입     | 설명                                                   |
| ---------------- | ------ | ---------------------------------------------------- |
| `id`             | string | 모델 ID (`kr/` 접두사 또는 `auto-*`)                        |
| `name`           | string | 모델 표시명                                               |
| `provider`       | string | 원본 제공자 (`openai`, `anthropic`, `google`, `k-router`) |
| `pricing`        | object | 1M 토큰당 USD 가격 (Auto Tier는 null)                      |
| `context_length` | number | 최대 컨텍스트 길이 (토큰)                                      |

## 예시

```bash cURL theme={null}
curl https://api.k-router.com/v1/models
```

```python Python theme={null}
from openai import OpenAI

client = OpenAI(
    api_key="kr-your-api-key",
    base_url="https://api.k-router.com/v1"
)

models = client.models.list()
for model in models.data:
    print(model.id)
```
