管理員指南

模型管理

管理平台所有模型的中繼資料與定價

在此維護模型名稱、描述、供應商、標籤與定價倍率，並支援從上游同步模型清單。管理員登入後，在左側邊欄「管理員區域 → 模型管理」進入，或直接造訪 `/console/models`。使用者端展示見模型廣場 `/models`。Web 控制台頁面與參考設計一致，正在串接中。

提示：此處設定主要用於控制「模型廣場」對使用者的展示效果，不會影響模型實際呼叫與路由。若需設定真實呼叫行為，請前往渠道管理設定渠道與 ability 能力表。

	圖標	模型名稱	匹配類型	官方同步	描述	供應商	操作
☐	◉	gpt-4o	精確	是	多模態旗艦模型	OpenAI	停用 · 編輯 · 刪除
☐	◉	claude-3-5-sonnet	精確	是	長上下文對話	Anthropic	停用 · 編輯 · 刪除

模型列表示意：展示提示、工具列與中繼資料表格

新增與編輯模型

新增模型

點擊「新增模型」開啟表單
填寫 model_name、描述、供應商等中繼資料
提交 POST /api/models/ 建立記錄

編輯模型中繼資料

欄位	說明
`model_name` · 模型名稱	必填，與呼叫時 model 參數一致
`description` · 描述	模型廣場展示說明
`icon` · 圖標	卡片圖標
`tags` · 標籤	如 chat、vision、reasoning
`vendor_id` · 供應商	關聯 vendor 表或廠商標識
`endpoints` · 端點	JSON 或逗號清單，宣告支援的 API 類型
`name_rule` · 匹配規則	模型名稱匹配方式
`sync_official` · 官方同步	是否參與上游同步

列內「編輯」或 GET /api/models/{id} 查看詳情後，使用 PUT /api/models/ 儲存。

設定定價

欄位	說明
`model_ratio` · 模型倍率	輸入 Token 計費倍率，詳見定價文件
`completion_ratio` · 補全倍率	輸出 Token 相對輸入的價格倍數
`model_price` · 固定單價	按次計費模型使用的單價（選填）
`cache_ratio` · 快取倍率	快取命中 Token 的計費倍率（若支援）

定價規則與使用者端展示說明見定價文件；實際扣費以使用日誌為準。

同步上游模型

預覽同步結果

點擊「同步」前可先呼叫 GET /api/models/sync_upstream/preview，查看將從渠道彙整出的新增/更新模型清單，避免誤覆蓋中繼資料。

執行同步

確認預覽後執行 POST /api/models/sync_upstream
同步合併各渠道 models 欄位中的模型名稱，不會自動建立渠道路由
真實呼叫路由請在渠道管理中設定渠道模型與 ability 表

列表欄位與操作

欄	欄位	說明
圖標	`icon`	模型展示圖標 URL 或內建標識
模型名稱	`model_name`	與 API 請求中的 model 欄位對應
匹配類型	`name_rule`	名稱匹配規則（精確 / 前綴等）
參與官方同步	`sync_official`	是否納入官方模型同步任務
描述	`description`	模型廣場卡片說明文案
供應商	`vendor_id`	所屬廠商或系列
標籤	`tags`	分類標籤，以逗號分隔
端點	`endpoints`	支援的 API 端點類型（如 chat、embedding）
狀態	`status`	啟用 / 停用；停用後不在模型廣場展示

新增模型（POST /api/model）：手動輸入模型中繼資料與定價
未設定模型（GET /api/models/missing）：查看渠道已支援但中繼資料未設定的模型
同步（POST /api/models/sync_upstream）：從上游渠道拉取模型並合併中繼資料
依渠道管理：跳轉至渠道管理，設定各渠道 models 欄位與路由
緊湊列表：切換表格密度，隱藏次要欄位

停用 / 啟用：切換 status，控制模型廣場可見性
編輯（PUT /api/model/{id}）：修改中繼資料與定價
刪除（DELETE /api/models/{id}）：刪除中繼資料記錄（不影響渠道已設定的模型）

使用者可見列表：/models（公開 GET /api/models）。管理員側邊欄模組：sidebar_modules.admin.models。