群組釘選

每個模型都由一個或多個供應商群組提供，各自有自己的價格。預設情況下金鑰使用 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"
  }
}

請放寬或取消固定，或稍後再試。模型本身是正常的。