分组固定

每个模型都由一个或多个提供商分组提供，各自有自己的价格。默认情况下密钥使用 auto：每个请求都发往最便宜且可用的分组。

固定会按模型覆盖这一行为。你自己选择它可以使用哪些分组，计费也锁定为这些分组的费率。

每个模型页面都在 Group Pricing 下列出了所有分组及其输入和输出价格。模型列表中的折扣标识反映最便宜的分组。

打开 API 密钥，创建或编辑一个密钥，然后打开分组选择器。搜索并点击某个模型，勾选一个或多个按价格从低到高排序的分组。未改动的模型保持 auto。

固定过的模型会排在最前面，并带有显示分组数量的标识。Clear all 会把密钥重置为 auto。密钥列表中，固定过的密钥显示为 auto +N。

被固定的模型只在其固定分组内路由，从便宜到贵，出错时依次切换。实际处理请求的分组决定计费费率。

将固定与关注搭配使用，即可在分组调价或宕机时第一时间知晓，请参阅： 通知

若只想固定单次请求而不改动密钥，可发送带有确切分组名称的 X-Group 请求头。它会覆盖密钥的固定设置和 auto 路由。名称请从 Group Pricing 复制。

curl https://api.unorouter.com/v1/chat/completions \
  -H "Authorization: Bearer $UNOROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Group: glm-new-pol-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"
  }
}

请放宽或取消固定，或稍后重试。模型本身是正常的。