# 模型列表

> GET /v1/models 返回当前令牌可用的模型,以及如何从中读取上下文窗口等元数据。

```
GET https://api.tokrouter.dev/v1/models
Authorization: Bearer sk-…
```

```bash
curl https://api.tokrouter.dev/v1/models \
  -H "Authorization: Bearer $TOKROUTER_API_KEY"
```

## 响应

```json
{
  "object": "list",
  "data": [
    {"id": "gpt-5.4-mini", "object": "model", "owned_by": "openai"},
    {"id": "claude-opus-5-5", "object": "model", "owned_by": "anthropic"}
  ]
}
```

返回的是**当前令牌可见**的模型 —— 不同分组可能看到不同的清单。

<Callout type="warn" title="这是活列表">
模型会随上游上下线,清单与数量随时可能变化。不要在代码或文案里硬编码「一共多少个模型」,
需要时每次请求这个端点。
</Callout>

## 与文档里的模型页的关系

[模型](/zh/models/)页按厂商列出上下文窗口与单价,数据在构建时从定价目录生成;
`/v1/models` 是运行时的可用性真值。两者的差集通常意味着「目录里有但当前不可用」或反之。

## 元数据

`/v1/models` 只保证 `id` 与 `owned_by`。上下文窗口、最大输出等元数据不在该端点的稳定契约里,
以[模型](/zh/models/)页为准。