调用指南

适用角色：子用户更新日期：2026-08-06

请求中的 model 决定目标模型，API Key 的绑定分组决定优先路由。大多数场景只需从控制台复制模型调用名；需要明确指定分组时，再使用带分组标识的完整调用名。

模型名称如何路由

平台按以下顺序选择分组：

API Key 需要绑定一个分组；
目标模型在绑定分组中时，直接使用该分组；
绑定分组没有目标模型时，查询当前用户和主用户设置的默认模型配置；
没有可用候选时，请求返回错误。

模型名称示例：

deepseek-v4-flash
kimi-k3

模型显示名称和调用名可能不同。建议从「调用指南」复制；也可以在「默认模型配置」中查看当前可用模型。

配置默认模型分组

「默认模型配置」用于设置回退分组，不能代替 API Key 的绑定分组。

打开「默认模型配置」；
搜索目标模型；
选择当前用户有权使用的分组；
选择分组后立即生效，页面会提示「已设置默认分组」；随后用模型名称发送一条请求验证。

默认模型配置

明确指定的分组不可用时，平台会返回错误，不会自动改用其他分组。需要高可用切换时，应由调用方根据错误类型选择其他模型或分组。

使用带分组标识的调用名

主用户启用「分组标识路由」、并且平台侧的站点总开关同时开启后，「调用指南」会展示完整调用名，例如：

A2C4E6G8/deepseek-v4-flash

前缀 A2C4E6G8 是分组标识。使用这种写法时，请求固定进入对应分组，不再使用 Key 绑定分组和默认模型配置。可指定的范围仍受当前用户的分组权限限制。

分组标识应从控制台复制，不要自行拼接。该功能未启用时，模型名称调用不受影响。

代码示例

# 使用模型名称
response = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)
 
# 使用控制台复制的完整调用名
response = client.chat.completions.create(
    model="A2C4E6G8/deepseek-v4-flash",
    messages=[{"role": "user", "content": "你好"}],
)

Base URL、认证和完整请求示例见开发者指南。

验证路由

发送一条短请求后，在「使用记录」中检查模型、Key 和分组。记录与预期不一致时，依次核对：

Key 当前绑定的分组；
默认模型配置；
model 是否包含分组标识；
当前用户是否拥有目标分组权限；
目标分组和渠道是否可用。

常见问题

API Key 未绑定分组还能调用吗？
模型名称调用会被拒绝。请先在「API Key」中绑定一个可用分组。

返回 Model Not Found 怎么处理？
从控制台重新复制调用名，并确认 Key 可以到达包含该模型的分组。

带分组标识是否可以访问任意分组？
不可以。只能访问组织和主用户已经分配给当前用户的分组。