Skip to Content
管理员后台AI 模型目录

AI 模型目录

配图占位：本节用于在后续视觉评审中插入「模型目录」列表页截图。

用途

/admin/ai-models 用于维护平台对外暴露的模型条目，包括模型键名、显示名、媒体类型、所属供应商与功能开关。一个模型记录同时承载多个历史「修订版本」，但同一时刻只有一个活动版本对外生效。

主要场景：

  • 首次上架新模型：选择供应商 → 填写键名/显示名/媒体类型 → 保存（生成 DRAFT 修订）→ 发布（切换为 active）。
  • 日常巡检：通过 8 列表格浏览当前活动版本、价格策略摘要与最近修订；按 ?providerId= 预筛选特定供应商。
  • 修订管理：点击行内「修订」打开抽屉，查看历史 draft / active / archived 修订轨迹。
  • 灰度切换：保留旧 active，在价格矩阵里把「默认」指针切换到新版本。

使用前准备

  • 仅管理员账号可见；登录态与会话由 AdminGuard 守护。
  • 必须先在 /admin/ai-providers 登记至少一个已启用供应商；本页面的「所属供应商」字段是必填外键。
  • 修订发布后立即影响对外调用方；建议在低峰期发布并提前在测试环境验证。
  • 价格中心（/admin/ai-pricing）的「默认」指针依赖本页面的当前修订版本号；调整后价格矩阵会自动重算。

操作步骤

  1. 打开 /admin/ai-models（可选 ?providerId=<uuid> 预筛选供应商）。页面由 AdminModelsPageClient 承载，并发请求 /api/admin/ai-providers 与 /api/admin/models。
  2. 点击「新建模型」并选择供应商（AdminModelEditorDrawer）：
    • 模型键名：必填，全局唯一，作为内部计费与分析的稳定 key。
    • 显示名：用户在产品中看到的名称，可本地化。
    • 媒体类型：text / image / video / audio / tts 等，决定可视化分组与默认能力位。
    • 所属供应商：必填，引用 ai-providers 中已启用的供应商，决定凭据与协议路由。
    • 执行模式：仅 ComfyUI 和 RunningHub 工作流 Provider 显示。固定工作流 必须绑定后台保存的工作流；代码动态工作流 由服务端根据本次参数构建完整 JSON，不需要固定绑定。两类 Provider 独立提交和轮询。
    • 能力位：流式 / Function Call / 多模态输入 / 图像理解 等开关。
    • 上下文长度：以 token 数计，用于提示词合法性校验。
    • 默认计费指标：token / image / second / character，决定价格矩阵中的计量列。
    • 启用：模型是否出现在对外可见列表，关闭后调用方将收到 404。
  3. 保存生成一条 draft 修订版本；点击「发布」将当前 draft 切换为 active，覆盖上一个活动版本。
  4. 若需灰度，保留旧 active，在 /admin/ai-pricing 矩阵里把「默认」切换到新版本即可。
  5. 禁用模型：关闭启用开关（行内 Switch），模型立即从对外调用方移除，但保留历史版本便于回滚。
  6. 删除模型（行内删除按钮）：走软删路径，硬删仅在合规场景保留。

结果与状态

  • 新建模型：表格首列显示「模型名 + key · protocol」格式；当前版本列显示「draftOnly」tag。
  • 发布修订：当前版本列切换为 v{n} · ACTIVE 绿色 tag；同时同模型的旧 active 自动转为 archived。
  • 启用 Switch：开启 → 行内显示「启用」灰色 id；关闭 → 「禁用」灰色 id。变更立即生效，无需刷新。
  • 按 ?providerId= 预筛选：URL 参数生效后表格上方显示可清除 chip；清空参数或刷新即可恢复全量列表。
  • 价格策略摘要列：优先显示当前修订的前两项计费指标、积分与单位；没有修订价格时显示所引用模板的价格明细、模板名和倍率。其余项目以数量提示，点击「在价格中心编辑」可跳转并预选该模型。
  • 绑定工作流列：固定模式显示已绑定或未绑定；代码动态模式显示「动态工作流」，不会被计入未绑定筛选和配置告警。
  • 修订抽屉：列出历史 draft / active / archived 轨迹，每条带 version / protocol / pricingDimensions / 发布时间戳。

权限和边界

  • 仅管理员账号可见；登录态与会话由 AdminGuard 守护。
  • 模型键名一旦发布，禁止原地修改；如需更换请新建模型并迁移所有引用。
  • 同一时刻只有一个 active 版本，多个 active 会被保存逻辑强制收敛为最新一份。
  • 删除策略：soft（默认停用即可）/ hard（物理删除，仅在极少合规场景使用）。
  • 模型目录变更不会自动同步到 prisma/model-prices.json，由后台管理页价格矩阵维护；调整后必须运行 npm run export:model-prices 固化。
  • 删除模型前必须先断开引用：/api/admin/models 的关联测试数据需要单独清理。
  • ?providerId 预筛选仅是视图过滤，不修改底层数据；刷新或清空参数即可恢复全量列表。

常见问题

  • Q：行内 Switch 切换启用状态后接口报错？ A：常见原因是 Switch 抖动期间连续触发；后端已支持幂等 PATCH（PATCH /api/admin/ai-models/{modelId} 接 {enabled}）。如持续失败，查看浏览器网络面板响应 message 字段。
  • Q：发布修订后价格矩阵没刷新？ A：发布只会切换模型的活动版本号；价格矩阵的「默认」指针需要单独在 /admin/ai-pricing 切到新版本才完成完整链路。
  • Q：?providerId= 不生效？ A：检查 URL 是否有重复 providerId 参数；确认 UUID 与 /api/admin/ai-providers 列表中的某条 id 一致。清空查询字符串或点击 chip 关闭按钮恢复全量。
  • Q：删除模型时提示「存在依赖数据」？ A：先到 /admin/ai-pricing 价格矩阵清理该模型的所有阶梯与修订，再到「测试/工作区」清理使用该模型的引用。
  • Q：RunningHub MiniMax H3 为什么没有绑定固定工作流？ A：该模型应选择「代码动态工作流」。平台 workflowId 仍用于定位远端执行环境，但参考图片、视频、音频节点由代码逐次拼接，并随请求发送完整 workflow JSON。

相关文档

Last updated on
AI 供应商管理AI 价格中心