# 查询接口文档

公开接口完全免费，无需密钥。可用于检索模型、服务商、实验室与排行数据。模型、服务商、实验室、排行与文档页均可加上 .md 后缀获取 Markdown 纯文本。

模型、服务商、实验室、排行与文档页都支持在地址后加上 .md 后缀，返回 Markdown 纯文本，便于程序和 AI 读取。无语言前缀的地址会按语言偏好打开对应版本。

- `/docs.md`
- `/zh/docs.md`
- `/en/docs.md`
- `/models.md`
- `/zh/models.md`
- `/en/models.md`
- `/providers.md`
- `/zh/providers.md`
- `/en/providers.md`
- `/labs.md`
- `/zh/labs.md`
- `/en/labs.md`
- `/rank.md`
- `/zh/rank.md`
- `/en/rank.md`

## 完全免费的查询接口

所有接口无需注册、无需密钥，可直接用于对照模型能力、服务商供给与排行数据。建议在应用中缓存结果，并遵守每分钟 120 次的公平使用上限。

## 调用约定

- 路径：/api/v1
- 数据格式：JSON，编码 UTF-8
- 跨域：已开放，可从浏览器直接请求
- 分页：page、page_size（最大 1000）

## 接口列表

### GET `/api/v1/models`

检索模型清单，支持搜索、实验室、服务商、能力、输入输出种类与排序。

参数：q, lab, provider, reasoning, tool_call, structured_output, open_weights, attachment, modality, input_modality, output_modality, sort, order, page, page_size

每条记录含 inputModalities、outputModalities，以及同样内容的 modalities.input / modalities.output。取值包括 text、image、audio、video、pdf。modality 匹配输入或输出；input_modality 只匹配输入，output_modality 只匹配输出。多个值用逗号分隔，需同时具备。

### GET `/api/v1/models/{id}`

读取单个模型及其输入输出种类，以及它在各服务商上的价格、限额、种类与思考控制。

参数：id 使用实验室/型号，例如 openai/gpt-5.5

供给会返回该服务商上的 modalities.input 与 modalities.output，取值包括 text、image、audio、video、pdf。

支持推理的供给会返回 reasoningOptions。toggle 表示可开关思考；effort.values 为强度档位，取值 none、minimal、low、medium、high、xhigh、max、default；budget_tokens 为思考 token 预算。空数组表示会思考，但调用方不能调节。

### GET `/api/v1/providers`

列出全部服务商及其模型数量。

参数：q

### GET `/api/v1/providers/{id}`

读取服务商详情与上架模型，含价格、限额、种类与思考控制。

供给会返回该服务商上的 modalities.input 与 modalities.output，取值包括 text、image、audio、video、pdf。

支持推理的供给会返回 reasoningOptions。toggle 表示可开关思考；effort.values 为强度档位，取值 none、minimal、low、medium、high、xhigh、max、default；budget_tokens 为思考 token 预算。空数组表示会思考，但调用方不能调节。

### GET `/api/v1/labs`

列出实验室及其模型、服务商覆盖。简介同时提供中文和英文。

参数：q

### GET `/api/v1/labs/{id}`

读取实验室详情与旗下模型。简介同时提供中文和英文。

### GET `/api/v1/rank`

按综合、智力或编程能力返回排行，可用 q 按模型、实验室或编号筛选。

参数：q, category=overall|intelligence|coding, limit（最大 1000）

### GET `/api/v1/coding-agents`

按综合指数、基准、成本、执行时间或 Token 返回 Coding Agent 排行，可用 q 与 model 筛选。

参数：q, dimension=overall|deepSwe|terminalBench|sweAtlasQna|cost|time|tokens, model, limit（最大 1000）

## 示例

- 列出模型: `/api/v1/models?page_size=5`
- 按能力筛选: `/api/v1/models?reasoning=true&tool_call=true&open_weights=true`
- 按种类筛选: `/api/v1/models?input_modality=image&output_modality=text&page_size=5`
- 查询单个模型: `/api/v1/models/openai/gpt-5.5`
- 服务商列表: `/api/v1/providers`
- 实验室详情: `/api/v1/labs/anthropic`
- 能力排行: `/api/v1/rank?q=claude&category=coding&limit=10`
- Coding Agent 排行: `/api/v1/coding-agents?q=claude&dimension=cost&limit=10`