GET https://routerbrain.ai/v1/models

返回已启用且对外目录可见的模型列表,格式与 OpenRouter Models API 一致(根级 data 数组)。

认证

无需 API Key — 便于集成前浏览目录。推理调用仍需 Key。

与 model 字段的对应关系

  • 列表项的 id(与 canonical_slug 同源)即 POST /chat/completions、POST /embeddings 等请求中的 model。
  • 仅目录隐藏(listed_in_catalog=false)但已对你启用的模型可能不出现在列表中,仍可按 code 调用 — 以控制台授权为准。

查询参数(均可选)

支持 snake_case 与 camelCase;多值可重复参数或逗号分隔。

参数说明
q / search / query关键词,匹配 code、name、description(最长 200 字符)
limit / page_size / pageSize每页条数 1–100;与 offset/page 联用时分页
offset / page偏移或页码(page 从 1 起)
sort / ordernewest、name、code(默认按 code 升序)
output_modalities筛选输出模态(@>)
input_modalities筛选输入模态
supported_parameters筛选支持的参数集合
api_protocol按线路协议精确筛选(联表路由)

分页时响应含 has_more。

示例

# 全量(或默认分页)
curl -sS "https://routerbrain.ai/v1/models"

# 搜索 + 分页
curl -sS "https://routerbrain.ai/v1/models?q=claude&limit=20&offset=0"

# 仅文本输出
curl -sS "https://routerbrain.ai/v1/models?output_modalities=text"

响应字段(摘要)

每条通常包含 id、name、description、pricing(prompt/completion 等字符串单价)、模态与架构信息等。定价为目录展示;账单以控制台为准。

模型详情与完整定价

GET https://routerbrain.ai/v1/models/{code}/endpoints 返回根级 data 对象,官网模型详情页使用此接口展示自定义模型的对客定价。

  • pricing:默认第一档价格,与列表的价格摘要保持一致。
  • pricing_tiers:按 sort_order 排列的全部普通定价阶梯;每档包含 max_prompt_tokens_inclusive 和 pricing,上限为 null 表示兜底档。
  • time_pricing:全部分时配置,包含时区、适用星期、起止时间及该时段的完整 tiers。

每档的 pricing 包含输入、输出、推理、缓存读取、缓存写入、5 分钟缓存写入和 1 小时缓存写入的单价,以及对应的原价、折后价和法币金额。阶梯按顺序匹配输入 Token 数,前一档上限不属于后一档范围。

相关