查看可用模型
适用角色:主用户、子用户 更新日期:2026-07-21
本文说明有哪几种方式查看平台的可用模型和"调用名",帮你搞清楚"平台提供哪些模型"和"我自己能用哪些模型"的区别,以及各方式分别适合什么场景。
"调用名"就是写代码时填在请求里的那串模型名字(如
claude-sonnet-4-6)。查到它,才能在代码或工具里点名用哪个模型。
一、先分清两个概念
| 概念 | 含义 | 在哪看 |
|---|---|---|
| 平台公开的模型 | 平台当前对外提供的模型,按公开分组展示 | 模型广场(无需登录) |
| 我自己可用的模型 | 你实际能调用的模型,受你被授权的分组和 Key 绑定的分组限制 | 控制台「调用指南」、/v1/models 接口(需登录 / 需 Key) |
简单说:模型广场是"菜单",你自己可用的是"你点得到的菜"。菜单上有的,你不一定都能用——取决于你的组织被授权了哪些分组。
二、方式一:模型广场(看平台都提供啥)
模型广场是平台的公开模型展示页,无需登录即可访问,入口在平台官网首页。
在模型广场你可以看到:
- 平台当前公开提供的模型及其供应商
- 每个模型在各公开分组下的价格
- 不同分组之间的价格对比
适合场景:还没注册、想先了解平台提供哪些模型;或想对比不同分组的价格。
模型广场展示的是公开分组下已配价、可用的模型。如果你的组织有专属分组,其中的模型不会出现在模型广场,需要登录后在调用指南里看。
三、方式二:控制台「调用指南」(看我自己能用啥、复制调用名)
登录控制台后,在左侧菜单找到「调用指南」页。它按分组列出你实际可用的全部模型(含公开分组和你被授权的专属分组),每个模型给出可以直接复制的调用名:
- 模型名称(如
claude-sonnet-4-6)——用它调用时走你 Key 绑定的分组 - 带识别码的完整调用名(如
A2C4E6G8/claude-sonnet-4-6)——直接点名走指定分组(需主用户开启"分组标识路由"后才有)
复制调用名,粘到代码或工具配置里就能用。
适合场景:已登录,想确认自己到底能用哪些模型、并把调用名复制到代码里。
主用户和子用户看到的范围不同:
- 主用户:看到公开分组 + 被授权的专属分组下的全部模型
- 子用户:在组织可见范围的基础上,还受自己 Key 绑定的分组限制,只显示你实际能调用的部分
「调用指南」页由你自己的「分组标识路由」开关控制(主用户在「API 密钥」页顶部或「子用户管理·设置」里打开,子用户跟随主用户)。开关没开时这个菜单不显示,属于正常——此时可用「默认模型配置」页确认模型和默认分组,或用下面的模型广场 / 接口方式查看。
默认模型配置页面(在这里为每个模型指定默认走哪个分组):

如果在调用指南里看不到某个模型,说明你的组织没被授权该模型或对应分组。请联系主用户或平台客服。
四、方式三:/v1/models 接口(写代码时动态获取)
如果你在写代码,可以通过接口查询当前 Key 能调用的模型列表:
curl YOUR_API_BASE_URL/models \
-H "Authorization: Bearer YOUR_API_KEY"返回的是当前这把 Key 绑定分组下的可用模型列表。
适合场景:在程序里动态拿到"这把 Key 能用哪些模型",不用手动维护清单。
需要注意:
- 不同 Key 绑定不同分组,查出来的列表可能不同
- 如果用带识别码的调用名(指定分组路由),目标分组下的模型不一定出现在这个列表里——这种调用方式不依赖此列表,只要分组实际支持该模型就能调用成功
接口的认证、端点等技术细节点到为止,完整用法见 开发者指南 · API 调用基础 与 调用指南与路由说明。
五、三种方式对比
| 方式 | 看到的范围 | 是否需登录 / Key | 适合场景 |
|---|---|---|---|
| 模型广场 | 公开分组下已配价的可用模型 | 不需要 | 了解平台提供哪些模型、对比分组价格 |
| 控制台「调用指南」 | 你的组织 / Key 实际可调用的模型(含专属分组) | 需登录 | 查调用名、复制到代码里、确认可用范围 |
/v1/models 接口 |
当前 Key 绑定分组下的模型 | 需 API Key | 代码里动态获取可调用模型列表 |
三者数据同源,都来自分组下配置的模型清单,区别只是过滤范围不同:模型广场按全部公开分组汇总,调用指南按你被授权的分组汇总,接口按单把 Key 绑定的分组返回。
六、常见问题
Q:模型广场里有的模型,为什么调用指南里没有? A:模型广场展示的是公开分组下的可用模型,但你的组织不一定被授权了所有公开分组。需要开通更多分组请联系主用户或平台客服。
Q:调用指南里有的模型,为什么模型广场里没有? A:你的组织可能有专属分组,其中的模型只对被授权的组织可见,不会出现在公开的模型广场。
Q:/v1/models 返回的列表和调用指南里的不一样?
A:接口返回的是当前这把 Key 绑定的那一个分组下的模型;调用指南是你所有可用分组的汇总。多把 Key 绑不同分组,各自查出来的列表会不同,但汇总起来应与调用指南一致。
Q:怎么知道某个模型的价格? A:在模型广场找到该模型,能看到它在各公开分组下的单价。登录后在调用指南里也能看到你可用分组的价格信息。以模型广场展示为准。
Q:子用户看到的模型比主用户少? A:正常。子用户的可见模型还受 Key 绑定的分组限制。需要访问更多模型,请联系主用户调整分组授权,或创建绑定其他分组的 Key。
