# Query API docs

The public API is free and requires no key. Use it to look up models, providers, labs, and rankings. Append .md to models, providers, labs, rankings, or docs addresses to get the Markdown text.

Append .md to models, providers, labs, rankings, or docs addresses to get the Markdown text for programs and AI. Addresses without a language prefix follow your language preference.

- `/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`

## A free query API

Every endpoint is open—no signup or API key. Use it to compare model capabilities, provider supply, and rankings. Cache results in your app and stay within the fair-use limit of 120 requests per minute.

## Conventions

- Path: /api/v1
- Format: JSON, UTF-8
- CORS: enabled for browser requests
- Pagination: page, page_size (max 1000)

## Endpoints

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

Search the model catalog by keyword, lab, provider, capability, input/output type, and sort order.

Parameters: q, lab, provider, reasoning, tool_call, structured_output, open_weights, attachment, modality, input_modality, output_modality, sort, order, page, page_size

Each item includes inputModalities, outputModalities, and the same values as modalities.input / modalities.output. Values include text, image, audio, video, and pdf. modality matches input or output; input_modality matches input only; output_modality matches output only. Comma-separated values must all be present.

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

Read a single model, its input/output types, and its pricing, limits, types, and thinking controls across providers.

Parameters: id uses lab/model, for example openai/gpt-5.5

Offerings include modalities.input and modalities.output for that provider. Values include text, image, audio, video, and pdf.

Reasoning offerings include reasoningOptions. toggle means thinking can be turned on or off; effort.values lists intensity levels (none, minimal, low, medium, high, xhigh, max, default); budget_tokens is a thinking-token budget. An empty array means the model thinks, but callers cannot adjust it.

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

List all providers and how many models they offer.

Parameters: q

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

Read a provider and the models it lists, including pricing, limits, types, and thinking controls.

Offerings include modalities.input and modalities.output for that provider. Values include text, image, audio, video, and pdf.

Reasoning offerings include reasoningOptions. toggle means thinking can be turned on or off; effort.values lists intensity levels (none, minimal, low, medium, high, xhigh, max, default); budget_tokens is a thinking-token budget. An empty array means the model thinks, but callers cannot adjust it.

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

List labs with their models and provider coverage. Descriptions are available in Chinese and English.

Parameters: q

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

Read a lab and the models it publishes. Descriptions are available in Chinese and English.

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

Rankings for overall, intelligence, or coding ability. Use q to filter by model, lab, or ID.

Parameters: q, category=overall|intelligence|coding, limit (max 1000)

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

Coding agent rankings by overall index, benchmark, cost, execution time, or token usage. Use q and model to filter.

Parameters: q, dimension=overall|deepSwe|terminalBench|sweAtlasQna|cost|time|tokens, model, limit (max 1000)

## Examples

- List models: `/api/v1/models?page_size=5`
- Filter by capability: `/api/v1/models?reasoning=true&tool_call=true&open_weights=true`
- Filter by type: `/api/v1/models?input_modality=image&output_modality=text&page_size=5`
- Look up a model: `/api/v1/models/openai/gpt-5.5`
- List providers: `/api/v1/providers`
- Lab details: `/api/v1/labs/anthropic`
- Capability ranking: `/api/v1/rank?q=claude&category=coding&limit=10`
- Coding agent ranking: `/api/v1/coding-agents?q=claude&dimension=cost&limit=10`