调用指南

适用角色：子用户更新日期：2026-07-21

本文讲一件事：调用模型时，那个"模型名"到底怎么填、平台又是怎么决定你这次请求走哪个分组的。

提示：这里说的「调用指南」页，正常情况下你可能看不到它的菜单——它由你主用户的「分组标识路由」开关控制（你自己改不了，跟随主用户）：主用户开了你才看得到，没开就隐藏，属于正常，不影响你正常调用。看不到时，本文"进阶用法"那部分先跳过即可。

完整的接入方式（请求怎么发、装什么 SDK、报错怎么看）见开发者指南。

一、先搞清楚：调用时到底走哪个分组

你调用模型时要填一个"模型名"。平台拿到请求后，按下面的顺序决定这次走哪个分组：

先看你这把 Key 绑的分组——绑了就走它（建 Key 时必须选一个分组，所以正常情况下都有）。
Key 没绑分组时，再看你在「默认模型配置」里给这个模型指定的默认分组——配了就走它。
上面两条都没有，这次调用就被拒绝（平台不会偷偷帮你随便挑一个分组兜底）。

一句话：只要你建 Key 时选了分组，直接用模型名调用就能用，不用再折腾别的。

二、普通用法：用模型名称直接调用

绝大多数人只需要这一种用法。

模型名称长这样：claude-sonnet-4-6、gpt-4o 之类。
去哪拿模型名？两个地方都行：平台官网的"模型广场"（公开页面，不用登录也能看），或者控制台里的「默认模型配置」页。
拿到名字，填进你的代码/工具的"模型"那一栏，配合你的 Key，就能调了。

给模型配个默认分组（可选）

「默认模型配置」页的作用是：给每个模型名指定一个"默认走哪个分组"。这样即使某把 Key 没绑分组，用模型名调用时也有个默认分组可走。

这个页面一直都在、随时能进，不受任何开关影响。
页面是个表格：模型 / 供应商 / 默认分组 / 折扣 / 操作。可以搜模型名，也能"按供应商批量设置"（批量设置有二次确认，且设置后覆盖不可撤销，慎点）。
你能配的分组范围，也是主用户授权给你的那些。

默认模型配置页面：

默认模型配置

注意：如果你要走的那条线路当时不可用，平台会直接返回错误，不会自动帮你换一条线路。

三、进阶用法：带"识别码"点名走某个分组（需开关开启）

这一节只有在主用户开了「分组标识路由」开关时才用得上；没开就跳过。

平台会给每个分组配一串短短的"识别码"（比如 A2C4E6G8）。把识别码加在模型名前面，就能临时点名走那个指定分组，而不用去改默认配置。完整调用名长这样：

A2C4E6G8/claude-opus-4-5

这种"识别码/模型名"的完整写法，在「调用指南」页里能直接看到并复制，你不用自己记识别码。
用了识别码，就固定走识别码对应的那个分组，不再受前面第一节那套优先级影响。
但你依然只能点名走主用户授权给你的分组，点别的会被拒。

关于这个开关：它是进阶开关，子用户只能跟着主用户的设置走、自己改不了。开关没开时——「调用指南」菜单看不到、带识别码的调用会被拒。但这不影响你用普通模型名称正常调用。

四、怎么填进代码（示例）

下面只演示"模型名该填什么"，其余接入步骤见开发者指南。这里的 model 就是你要用的模型名字：

# 普通用法：直接填模型名称
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}]
)
 
# 进阶用法（主用户开了分组标识路由后才可用）：模型名前面加上识别码
response = client.chat.completions.create(
    model="A2C4E6G8/claude-sonnet-4-6",
    messages=[{"role": "user", "content": "你好"}]
)

五、常见问题

Q：为什么我没有「调用指南」这个菜单？ A：它由主用户的「分组标识路由」开关控制，主用户没开就不显示，属于正常。用普通模型名称调用完全不受影响。想用带识别码的进阶写法，找主用户开这个开关。

Q：普通模型名和带识别码的，用哪个好？ A：一般用普通模型名就够了，简单直接。只有当你想临时点名走某个特定分组时，才用带识别码的写法（前提是开关已开）。

Q：我的 Key 没绑分组，还能调用吗？ A：如果你在「默认模型配置」里给这个模型配了默认分组，能调；否则会被拒。最省心的办法就是给 Key 绑上一个分组。

Q：model 填错了会怎样？ A：填了不存在的、或你没权限用的模型名，调用会被拒。建议从"模型广场"或「默认模型配置」页抄准确的模型名。

Q：带识别码是不是能点名走任意分组？ A：不是。仍然只能走主用户授权给你的分组，点别的会被拒。