分组固定
把模型锁定到指定的提供商分组,而不是走最低价路由。
每个模型都由一个或多个提供商分组提供,各自有自己的价格。默认情况下密钥使用 auto:每个请求都发往最便宜且可用的分组。
固定会按模型覆盖这一行为。你可以选择它能使用哪些分组以及按什么顺序尝试,计费随之锁定为它们的费率。
每个模型页面都在 Group Pricing 下列出了所有分组及其输入和输出价格。模型列表中的折扣标识反映最便宜的分组。

打开 API 密钥,创建或编辑一个密钥,然后打开分组选择器。搜索并点击某个模型,勾选一个或多个分组。未改动的模型保持 auto。

固定过的模型会排在最前面,并带有显示分组数量的标识。Clear all 会把密钥重置为 auto。密钥列表中,固定过的密钥显示为 auto +N。
无需逐个勾选通道,只要拖动模型上的双滑块价格区间,即可仅通过费率落在该区间内的供应商路由。由于按价格而非名称筛选,新进入该区间的供应商会被自动纳入。

价格区间和固定的线路会合并:区间覆盖便宜的提供商,固定则把某个较贵的提供商保留为备用,即使它在区间之外。选择最便宜优先时,只有更便宜的线路全部失败才会用到这个备用;选择我的顺序时,由你决定它的位置。
切换为自动后,模型会回到常规的最便宜优先链路。其区间与固定设置仍会保存但不生效,因此关闭自动即可原样恢复之前的配置。

在线路列表下方,故障转移顺序决定所选线路按什么顺序尝试。默认是最便宜优先:线路从费率最低到最高排列,列表只显示这个顺序,不能更改。

切换到我的顺序后,可以把所选线路拖成任意顺序。请求会先尝试最上面的线路,只有失败时才往下,因此你可以优先使用信任的提供商而不是更便宜的。按价格排序可把列表恢复为最便宜优先。不可用的线路会保留位置,恢复前会被跳过。

设置了价格区间时,区间加入但你没有勾选的线路会排在你的列表之后,最便宜的优先。之后进入区间的提供商也会排到那里。
固定的模型只在其固定的分组内路由,出错时按故障转移顺序中设置的顺序切换。实际处理请求的分组决定计费费率。
将固定与关注搭配使用,即可在分组调价或宕机时第一时间知晓,请参阅: 通知
若只想固定单次请求而不改动密钥,可发送带有确切分组名称的 X-Group 请求头。它会覆盖密钥的固定设置和 auto 路由。名称请从 Group Pricing 复制。
curl https://api.test.wanmo.ai/v1/chat/completions \
-H "Authorization: Bearer $UNOROUTER_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Group: glm-new-relay-glm-5.2" \
-d '{
"model": "glm-5.2",
"messages": [{ "role": "user", "content": "Hello" }]
}'请求头必须指定该密钥可用的分组,否则请求会被拒绝。未固定的模型仍走最低价路由。
如果所有被固定的分组都已宕机,而其他提供商仍在提供该模型,请求会返回一个具体错误,而不是笼统的繁忙提示:
{
"error": {
"message": "Your pinned provider groups for model \"glm-5.2\" are currently unavailable, but the model is still served by other providers. Edit this key's group override, or try again later.",
"type": "new_api_error",
"code": "get_channel_failed"
}
}请放宽或取消固定,或稍后重试。模型本身是正常的。