模型查找与权限
在控制台和 API 中查找可用模型,理解分组和密钥模型限制如何决定一个 API Key 能调用哪些模型,以及无权限时的报错。
在哪里找模型
| 入口 | 能看到什么 |
|---|---|
| 控制台「模型广场」 | 平台上架的模型名称和价格 |
| 模型价格页 | 模型价格与可用性 |
GET /v1/models | 当前 API Key 实际能调用的模型 |
请求中的 model 必须使用完整模型 ID。模型名以「模型广场」和 GET /v1/models 为准。
什么决定了能调用哪些模型
一个 API Key 能调用的模型由两层共同决定:
- 分组:密钥所属分组中已启用的模型。分组同时决定渠道与计费策略。
- 模型限制:如果密钥设置了「模型限制」,只能调用其中列出的模型。
GET /v1/models 返回的就是这两层过滤后的结果。同一账户下不同密钥查到的模型列表可能不同。
调用不到某个模型时
- 用该密钥调用
GET /v1/models,确认模型是否在返回结果中。 - 不在结果中:在「API 密钥」页检查该密钥的分组和模型限制。
- 在结果中但仍报错:核对模型名拼写,并确认请求的接口路径是该模型支持的,见协议兼容性与迁移说明。
模型、分组或 IP 无权限时通常返回 403,见鉴权、余额与权限问题。