#复合 Key

复合 Key 是同时绑定多个分组的 API Key：每个分组配一个前缀，调用时在模型 ID 前加前缀即可指定走哪个分组。不用为每个分组单独建 Key，也不用在客户端里来回切配置。

#创建复合 Key

1. 在API 密钥页面点击创建密钥。
2. 填写名称，打开复合 Key开关。
3. 在映射编辑器里逐行选择分组并填写前缀。
4. 需要更多分组就继续添加映射，保存。

编辑已有 Key 时同样可以打开这个开关，操作一致。

实拍截图

#前缀规则

• 长度 1–32 位，只能用字母、数字、下划线、连字符；
• 不区分大小写，GPT 和 gpt 算同一个前缀，不能重复；
• 同一分组在一个 Key 里只能出现一次;
• 单个复合 Key 的映射数量有上限，以创建页面提示为准。

#调用方式

模型 ID 写成 前缀/模型ID。假设绑定了 fast → 高速分组、cheap → 低价分组：

{ "model": "fast/claude-sonnet-4", "messages": [{ "role": "user", "content": "你好" }] }

{ "model": "cheap/deepseek-v3", "messages": [{ "role": "user", "content": "你好" }] }

#模型列表自动加前缀

用复合 Key 请求模型列表接口时，返回结果会聚合所有绑定分组的模型，并自动带上各自前缀。客户端拉一次列表就能直接选用，不需要手工拼前缀。

#计费

与普通 Key 完全一致：按前缀实际命中的分组倍率计价，额度、限流、过期时间等设置也一样生效。见计费说明。

#不支持的接口

复合 Key 不支持 WebSocket / Realtime 类实时接口——这类长连接可能在会话中途换模型，前缀无法固定分组。这些场景请用普通 Key。常规的对话、补全、生图、用量查询类接口都支持。

#常见错误

前缀问题统一返回 HTTP 400：

#相关入口

• 创建 API Key — 普通密钥的创建流程
• 计费说明 — 分组倍率如何计算
• 模型广场 — 查看各分组可用模型