管理员指南

模型管理

管理平台所有模型的元数据和定价

在此维护模型名称、描述、供应商、标签与定价倍率，并支持从上游同步模型列表。管理员登录后，在左侧边栏「管理员区域 → 模型管理」进入，或直接访问 `/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。