模型管理

• 模型管理仅 Admin 和 Root 可访问，从侧边栏「管理员」 → 「模型」或访问 /models/metadata 进入。
• 页面维护本站的模型资料、名称匹配、模型广场展示、供应商和预填充分组，并提供定价入口、资料与价格同步和 io.net 模型部署。
• 渠道中的实际模型、分组和路由由渠道管理维护；价格规则见计费与支付配置和计费表达式。

模型管理概览

页面顶部有「模型」「供应商」「部署」三个标签，地址分别为 /models/metadata、/models/vendors、/models/deployments。「模型」标签右上角为「同步资料」「同步价格」「添加模型」和「⋯」菜单（「缺失的模型」「预填充分组」），下方为搜索框、筛选和模型列表。

• 模型管理-模型列表

Admin 与 Root 的差异

模型资料、供应商、预填充分组和模型部署，Admin 与 Root 都可以管理；模型定价只有 Root 可以修改。

列表字段

除已有模型资料的记录外，列表还会列出渠道（含已禁用渠道）模型列表中出现、但没有精确同名资料的模型名称。这类行标为「缺元数据」，只能「补充资料」或复制名称。列表不支持按列排序：已有资料的记录按 ID 倒序，之后是「缺元数据」行按名称排序；默认每页 20 条。

右上角「查看」可显示或隐藏列；ID、供应商、匹配类型、说明信息、自定义端点、创建时间、更新时间默认隐藏。

广场展示状态

搜索与筛选

四个筛选均为单选，可组合使用。使用「展示策略」「同步策略」或「供应商」筛选时，列表不显示「缺元数据」行。

行操作与批量操作

• 「编辑」：打开编辑抽屉的「模型资料」标签；「缺元数据」行显示为「补充资料」，打开带有该模型名的创建抽屉。
• 「定价」：仅 Root 可见，打开同一抽屉并定位到「定价」标签。
• 「⋯」菜单：「从模型广场隐藏」或「在模型广场显示」（只修改「广场展示」开关），以及「删除」；「缺元数据」行没有此菜单。

勾选行后，列表底部显示批量操作：

选中项中有「缺元数据」行时，只能复制模型名称；其他操作会提示「请先为所有选中模型补充元数据。」

添加与编辑模型

点击「添加模型」打开「创建模型」抽屉；点击模型名称、「编辑」或「补充资料」打开以模型名为标题的抽屉。抽屉有「模型资料」「定价」「渠道与分组」三个标签，各标签分别保存。

• 模型管理-创建模型

• 新建时只能先填写「模型资料」；保存后「定价」「渠道与分组」才可用。从「补充资料」或「缺失的模型 → 配置」进入时，模型名已带入，三个标签都可用。
• 关闭抽屉时，如果资料或定价有未保存的修改，会提示「放弃未保存的修改？」。

模型资料

• 模型管理-编辑模型-模型资料

点击「保存资料」保存；失败原因显示在抽屉底部。定价有未保存的修改时不能修改模型名称，需先保存或放弃定价修改。

名称匹配规则

• 同一个模型名称命中多条资料时，按完全匹配、前缀、后缀、包含的顺序取第一条。
• 匹配规则只用于模型资料（说明、图标、标签、供应商、端点、广场展示）；价格始终按具体模型名称配置，不会随规则传播。
• 使用非完全匹配规则时，渠道中的具体名称不会写入模型资料，「缺失的模型」中仍可能出现这些名称；删除时也不能「同时从所有渠道移除」。

端点配置

端点配置描述模型向用户展示的端点类型和自定义路径，不是渠道 Base URL，也不会创建上游渠道。可以按行填写「端点类型」和「配置」，也可以切换「JSON 模式」；「加载模板...」用所选模板（openai、openai-response、anthropic、gemini、jina-rerank、image-generation、embeddings）替换当前全部内容。

保存时后端校验：

• 留空表示不设置；否则必须是 JSON 对象（或端点类型字符串数组）。
• 对象的键为端点类型，不能为空；值为以 / 开头的路径，或包含 path（以 / 开头）和可选 method（GET、POST、PUT、PATCH、DELETE、HEAD、OPTIONS）的对象。

「渠道与分组」标签中的「支持的端点」由已启用渠道推导，与此处的自定义端点是两回事。

定价

• 模型管理-编辑模型-定价

• 只有 Root 可以编辑；Admin 打开此标签只看到「模型定价由超级管理员管理。」
• 完全匹配规则的模型直接编辑本模型的价格；其他规则需先在「选择模型」中选择一个匹配到的具体模型，再配置它的价格。
• 顶部显示当前生效的计费摘要；「恢复默认定价」移除此模型的自定义价格并恢复内置默认值，没有默认价格的模型会变为未定价。
• 下方编辑器与计费与支付配置 → 模型价格相同，字段和计费方式见该页与计费表达式。点击「保存模型价格」保存，与「模型价格」中修改的是同一份配置。
• 打开抽屉后如果此模型的价格在其他地方被修改，保存会失败，点击「重新加载定价」后再修改。

渠道与分组

• 模型管理-编辑模型-渠道与分组

此标签只读，内容由已启用渠道推导：广场展示状态、「绑定渠道」（渠道及其类型）、「启用分组」和「支持的端点」；非完全匹配规则另列「匹配模型」。创建或导入模型资料不会创建可调用的渠道，模型要被调用，需在渠道管理中把它加入渠道。

删除模型

在行「⋯」菜单中点击「删除」删除单个模型，或勾选后点击「删除选定的模型」批量删除（一次 1–1000 个）。「缺元数据」行没有模型资料，不能删除。确认框「删除模型？」中有两个可选项，默认都不勾选：

• 两项都不勾选时，只删除模型资料；渠道中的模型名称、能力和价格都保留。只要启用的渠道仍引用该名称，它会重新出现在列表的「缺元数据」行和「缺失的模型」中。
• 删除后可以重新创建同名模型资料。

缺失的模型

• 模型管理-缺失的模型

在「模型」标签右上角点击「⋯ → 缺失的模型」打开。列表显示已启用渠道正在使用、但没有精确同名模型资料的模型名称；被前缀、包含或后缀规则覆盖的名称仍会列出。

• 可按名称搜索，每页 20 条。
• 点击行内「配置」，打开带有该模型名的「创建模型」抽屉。
• 点击底部「同步缺失资料」，打开同步资料向导。
• 「缺失的模型」只统计已启用渠道；模型列表中的「缺元数据」行还包括已禁用渠道中的名称，两处数量可能不同。

同步资料

点击「同步资料」打开「同步模型资料」向导，从官方元数据目录导入模型的说明信息、图标、标签、供应商、自定义端点、匹配类型和广场展示，必要时新建供应商。

• 同步只修改模型资料：不会添加渠道、开放模型访问或配置价格，也不会修改模型名称和「允许资料同步」开关。
• 默认数据源为 https://basellm.github.io/llm-metadata（部署方可用环境变量 SYNC_UPSTREAM_BASE 替换），服务器需要能访问该地址；向导第 1 步会显示实际的模型来源和供应商来源。
• 每次同步都要经过预览和确认，不会自动同步。执行中不能关闭向导。

选择模型

• 模型管理-同步模型资料-选择模型

1. 选择「资料语言」（中文、英文或日语），点击「加载资料预览」。切换语言会清空已加载的预览和选择。
2. 选择「同步范围」：「本站使用的模型」（默认，即已有资料的模型和缺失的模型）或「上游模型列表」（官方目录中的全部模型）。
3. 按需搜索或勾选「仅看可同步」，勾选模型，或点击「全选可同步项」（跨页）；点击「预览所选变更」。

「计划操作」列说明每个模型能否同步：

预览字段

• 模型管理-同步模型资料-预览字段

每个已选模型列出「应用」「字段」「当前值」「更改为」。

• 新增资料：导入全部 7 个字段（见下表），无需勾选。
• 资料变更：只列出与官方不同的字段，默认都不勾选；勾选的字段会被「更改为」中的内容替换，未勾选的保持不变。「全选变更字段」「取消全选」作用于所有已选的「资料变更」模型。
• 没有新增模型、也没有勾选任何字段时，「检查并确认」不可用。

确认变更

• 模型管理-同步模型资料-确认变更

检查将要创建或更新的模型、字段和新增供应商，点击「应用 N 个模型的变更」。所有变更在一次提交中写入，任何一项写入失败，本次变更都不会应用。

同步结果

• 模型管理-同步模型资料-同步结果

显示「资料同步完成」、创建与更新的模型数量、新增的供应商，以及每个模型已应用的变更。未处理的模型不在结果中列出，原因见第 1 步的「计划操作」。

同步价格

• 模型管理-同步模型定价

「同步价格」仅 Root 可见，点击打开「同步模型定价」对话框：

• 与计费与支付配置 → 上游价格同步是同一功能：选择价格来源、对比当前价格、按模型选择来源，预览确认后保存。字段和操作细节以该页为准。
• 保存的价格与「模型价格」、编辑抽屉「定价」标签修改的是同一份配置。

选择价格来源

• 模型管理-同步模型定价-选择价格来源

点击「选择价格来源」，勾选要对比的预设或渠道，点击「确认选择」后列表按所选来源显示价格。

预览价格变更

• 模型管理-同步模型定价-预览价格变更

为模型选择来源后点击「应用同步」，在「预览价格变更」中核对价格来源、当前计费和最终保存价格，点击「确认更改」保存。

预填充分组

• 模型管理-预填充分组管理

在「模型」标签右上角点击「⋯ → 预填充分组」，打开「预填充分组管理」。预填充分组保存一组可复用的值，不是用户分组或渠道分组，也不影响计费。列表显示分组名称与描述、类型、条目（最多显示 6 个）和操作（编辑、删除）；点击「新建分组」创建，「刷新」重新加载。

创建预填充组

• 模型管理-创建预填充组

供应商

• 模型管理-供应商管理

「供应商」标签（页面标题「供应商管理」）维护模型所属的供应商。

• 搜索框「搜索供应商名称或简介」；「模型归属」筛选「有关联模型」或「无关联模型」；「查看」可显示 ID、创建时间、更新时间（默认隐藏）。
• 「关联模型」列显示归属该供应商的模型资料数量，点击跳到「模型」标签并按该供应商筛选。
• 行「⋯」菜单为「编辑」「删除」；勾选多行后可「合并供应商」「删除供应商」。默认每页 20 条。

添加供应商

• 模型管理-创建供应商

点击右上角「添加供应商」打开「创建供应商」抽屉，填写后点击「保存资料」。

编辑供应商

• 模型管理-编辑供应商-供应商资料

点击供应商名称或「⋯ → 编辑」打开以供应商名为标题的抽屉，有「供应商资料」「关联模型 (N)」两个标签。「供应商资料」的字段与创建时相同，另显示创建时间和更新时间。打开后如果该供应商被其他人修改，保存会失败，点击「重新加载供应商资料」后再修改。

关联模型

• 模型管理-编辑供应商-关联模型

列出归属该供应商的模型资料记录及其「名称匹配规则」「匹配模型」数量；点击「查看已筛选模型列表」跳到「模型」标签。勾选模型后可「设置供应商」（改到其他供应商）或「清除供应商归属」。关联数量按资料记录统计，非完全匹配规则覆盖的模型数单独显示。

合并与删除供应商

• 设置供应商、清除供应商归属、合并和删除都要先「预览更改」，核对来源供应商、目标供应商和受影响的记录后再「应用更改」；一次最多 1000 条。
• 这些操作只修改供应商归属，定价、渠道和模型名称保持原值。
• 预览后数据发生变化时，应用会失败并提示重新预览，点击「重新预览」即可。

模型部署

• 模型管理-模型部署未启用

「部署」标签管理 io.net 上的容器部署，Admin 与 Root 都可使用。使用前，Root 需要在系统设置 → 模型 → 模型部署中启用服务并保存 API Key。

• 进入标签时先检查配置和连接。未启用时显示「模型部署服务未启用」；连接失败时显示「连接失败」和错误信息，可点击「重试」。两种状态下的「前往设置」都打开系统设置中的模型部署配置，只有 Root 可以进入。
• 创建部署不会新建或绑定渠道。需要通过 AIMirrorX 调用部署的模型时，请在渠道管理中添加渠道，并把 Base URL 指向部署的公开地址。

部署列表

列表显示「ID」「名称」「状态」「提供商」（io.net）「剩余时间」「硬件」「创建时间」。可按名称搜索，或按状态筛选：「运行中」「已完成」「失败」「部署已请求」「终止请求」「已销毁」。

创建部署

• 模型管理-创建部署

模型部署服务启用后，点击右上角「创建部署」，填写后点击「新建」。

可用硬件、位置和价格以 io.net 为准，不要把页面默认值当作所有实例的固定规格。

查看与管理部署

故障排查

相关文档

• 渠道管理：在渠道中配置实际可调用的模型、分组与路由，使用「预设分组」。
• 计费与支付配置：模型价格、上游价格同步、分组价格等全局计费设置。
• 计费表达式：「定价」标签中计费表达式的语法与示例。
• 模型配置：启用 io.net 模型部署并配置 API Key。
• 模型广场和排行榜：用户侧如何看到模型广场中展示的模型。