查看可用模型

适用角色:主用户、子用户 更新日期: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。