模型列表
列出这把 Key 能调用的模型、模型 id 的格式,以及扩展字段的含义。
httpGET https://api.scirouter.cn/v1/models
GET https://api.scirouter.cn/v1/models/{model_id}和 OpenAI 的模型接口同一个形状,另附一个 scirouter 扩展字段。
模型 id
形如 厂商/模型名,例如 bio/protein-72b:
- 前一段是接入这条线路的厂商,只含小写字母、数字、
.、_、-; - 后一段是模型名,可以含大写字母;
- 调用时
model字段原样填这一整串。
不要从展示名推 id,以列表接口返回的为准。
列出能调用的模型
bashcurl https://api.scirouter.cn/v1/models \
-H "Authorization: Bearer $SCIROUTER_API_KEY"json{
"object": "list",
"data": [
{
"id": "bio/protein-72b",
"object": "model",
"created": 1757894400,
"owned_by": "bio",
"scirouter": {
"domain": "life-science",
"display_name": "Protein 72B",
"status": "available",
"pricing": [
{ "dimension": "input_tokens", "dimension_label": "输入", "unit": "1M tokens", "ratio_micro": 100 }
]
}
}
]
}只列这把 Key 此刻能调用的模型:已下线的不列,Key 白名单与套餐之外的不列。 所以同一个账号下两把 Key 拿到的列表可能不一样——这是对的,列表回答的是「用这把 Key 能调谁」。
scirouter 扩展字段:
| 字段 | 含义 |
|---|---|
domain | 所属科研领域:life-science、medicine、chemistry、materials、physics、math、earth、agriculture、environment、engineering、cs、general |
display_name | 展示名,给人看的 |
status | available(正常)/ degraded(部分线路异常,仍可调用)/ maintenance(维护中) |
pricing | 计价维度列表。维度不止输入 / 输出两种,见「多厂商差异」;换算成价格以模型详情页和控制台账单为准 |
官方 SDK 会忽略它不认识的 scirouter 字段,client.models.list() 照常可用。
查一个模型
bashcurl https://api.scirouter.cn/v1/models/bio/protein-72b \
-H "Authorization: Bearer $SCIROUTER_API_KEY"id 里的 / 直接写在路径里即可,写成 bio%2Fprotein-72b 也认。
看不到的模型一律 404 model_not_found,不区分「不存在」和「这把 Key 无权调用」——
后者如果返回 403,等于告诉任何拿到 Key 的人「平台上有这个模型」。
而调用接口对白名单外的模型返回的是 403 model_not_allowed:那时你已经明确点名要它了,告诉你「不许」才有用。
挑模型
列表适合程序读。要比较模型——能力、上下文长度、价格、近期可用率——去模型中心, 可以按领域筛选,最多五个并排对比。