系列「每天一个高质量 API」第 20 篇。搜蚁智选(souyi.net.cn)是一个面向 AI Agent 的 API 发现与统一调用平台。今天聊 OpenRouter 模型清单(ai-openrouter-models)。
470 个模型的实时目录:上下文长度、输入输出单价、模态,选型 Agent 的一手数据。
这个 API 能做什么
/api/v1/models 返回当前可用模型全量目录:id、name、context_length、pricing(prompt / completion,按 token 计价的字符串)、architecture(输入输出模态、分词器)、description。当前返回 470 个模型,其中 id 带 :free 后缀的是免费档。
为什么 AI Agent 需要它
- 选型 Agent:按「上下文 ≥ 100 万 + 单价为 0」这类条件直接筛。
- 成本预估:
pricing是字符串形式的单价,乘 token 数即可估算账单。 - 能力发现:
architecture.modality告诉你这个模型收不收图、出不出音频。
怎么用
方式一:直连上游(免费、无需 Key)
curl "https://openrouter.ai/api/v1/models"
方式二:经搜蚁智选一键调用(带 Key,统一计费 / 限流 / 可观测)
curl -X POST https://souyi.net.cn/api/v1/ai/request \
-H "X-API-Key: YOUR_AIMALL_KEY" \
-H "Content-Type: application/json" \
-d '{"asset_id":"ai-openrouter-models","call_data":{}}'
这些免费 API 的上游本身免密;经搜蚁智选代理后,多个数据源可以聚合到同一个 Agent 工作流里,统一走 X-API-Key + 统一计费、限流与可观测,省去每个上游单独接一遍。
返回示例
{
"count": 470,
"first": {
"id": "minimax/minimax-m3.1-flash:free",
"name": "MiniMax: MiniMax M3.1 Flash (free)",
"context_length": 1000000,
"pricing": { "prompt": "0", "completion": "0" }
}
}
价格
免费。目录接口无需 Key,OpenRouter 对查询类请求不限流。
怎么拿到 Key
注册 souyi.net.cn → 控制台一键生成 X-API-Key → 即可调用平台全部 API(含本系列 22 个)。
小结
模型半年一换,写死的选型表很快就过时。让 Agent 每次现查这份目录,才跟得上价格与上下文长度的变化。
更多免费 API 见 系列目录。