群組釘選
把模型鎖定到指定的供應商群組,而不是走最低價路由。
每個模型都由一個或多個供應商群組提供,各自有自己的價格。預設情況下金鑰使用 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"
}
}請放寬或取消固定,或稍後再試。模型本身是正常的。