管理員指南

分組管理

分組用於隔離不同使用者的渠道存取權限和計費倍率

分組是連接使用者、令牌與渠道的橋樑：使用者只能使用與其分組相符的渠道；不同分組可設定不同的計費倍率（group_ratio）。管理員透過 `GET /api/group/` 檢視分組列表，使用 `prefill_group` 介面維護分組名稱與倍率。Web 控制台頁面與參考設計一致，正在對接中。

分組的使用方式

分組貫穿使用者、令牌與渠道三層設定，共同決定「誰能用哪些渠道、依什麼倍率計費」：

編輯使用者時指定所屬分組（user.group）。使用者只能使用與其分組相符的渠道；模型廣場與定價也會依使用者分組顯示可用模型與倍率。

相關欄位：user.group · 詳見使用者管理

建立或編輯令牌時指定渠道分組（token.group）。API 呼叫依令牌分組比對 channel.group 與 ability 表進行路由；可開啟「跨分組重試」，在首選分組沒有可用渠道時嘗試其他分組。

相關欄位：token.group · 詳見令牌管理

令牌分組設為 `auto` 時，系統依優先順序自動選擇一個可用分組，適合需要跨分組容錯的情境。

添加或編輯渠道時設定分組（channel.group，預設 default）。僅當使用者/令牌分組與渠道分組一致時，該渠道才會參與路由。

相關欄位：channel.group · 詳見渠道管理

透過預填分組介面維護分組名稱與計費倍率；`GET /api/pricing` 回傳的 group_ratio 會反映到模型廣場的分組篩選與倍率標示。

欄位	說明
`name` · 分組名稱	如 default、vip、test；與 user / token / channel 的 group 欄位對應
`ratio / group_ratio` · 計費倍率	相對基準價格的倍數，模型廣場與 pricing 介面顯示為如 1.5x
`description` · 說明	選填，便於管理員識別用途

介面	說明
`GET /api/group/`	取得系統現有分組及倍率
`GET\|POST\|PUT\|DELETE /api/prefill_group/`	建立、更新、刪除分組定義
`GET /api/user/groups`	無需登入，供註冊或顯示使用