5. 模型定价与分类
完整版章节。内容按 2026.10 主线代码核对；具体入口以当前许可、账号权限和交付环境为准。
模型售价决定每次调用记入多少费用，也是模型服务金额预算和阶梯计价的基础。未定价的模型仍可调用，但其调用不计入金额统计，金额预算也会直接拒绝这类调用。
入口有两处：
- 「管理控制台 → 搭建 → 模型供应商 → 模型&定价」：按供应商查看和批量维护全部模型的售价；
- 供应商详情的「模型定价」页签：只维护该供应商的模型。
前提：租户管理员或「系统管理员」角色。售价币种为部署的结算币种；结算币种不是美元时，参照目录价需要先在全局设置中配置美元汇率（第 6.9 节）。本章功能属于基础功能许可。
5.1 设置模型售价
- 在「模型&定价」页签按供应商筛选或搜索模型，在目标行选择「编辑」，打开「编辑模型定价」。
- 在「计价模式」中选择「单个计价」「阶梯计价」或「分时计价」（分时计价见第 5.6 节）。
- 单个计价时填写四项单价「输入」「输出」「缓存命中」「缓存写入」，单位为“结算币种 / 百万 Token”。输入或输出留空按 0 计费；缓存价留空时，按供应商模型请求格式从输入价换算，输入框中会提示换算后的值。
- 按需设置「Token 权重」（单位“倍”）。Token 权重只把原始 Token 折算为额度消耗，不改变价格。
- 保存。每次保存生成新的价格版本，已结算的历史调用不受影响。
在列表中可用开关单独开启或关闭某个模型的计价，也可勾选多行后「批量编辑」「开启计价」「关闭计价」。
非 Token 计价的模型按用途使用对应单位，金额填在输入价位置，输出按 0 处理，不换算缓存价，也不支持阶梯计价：
| 用途 | 计价单位 |
|---|---|
| 图像生成 | 每张 |
| 语音转写 | 每分钟音频 |
| 语音合成 | 每百万字符 |
| 重排序 | 每千次搜索 |
同一次批量编辑中选中的模型计价单位不同时，平台拒绝保存并提示分别设置。
5.2 阶梯计价
阶梯计价按累计用量分档定价，适用于与上游按用量阶梯结算的场景。
- 在「编辑模型定价」中选择「阶梯计价」。
- 设置「累计周期」（本小时、今日、本月或累计）和「累计方法」（租户、用户、API 密钥或会话）。
- 选择「计价方式」：「单价」（每档填写四项单价）或「Token 倍率」（每档价格 = 基础价 × 倍率，倍率大于 0，最多 3 位小数）。
- 选择「计算方式」：「分段累进」按档位边界把一次调用拆开计价；「全量按最终档」整笔按调用结束时所在档位计价。
- 在「价格区间」中「添加档位」，用量单位为“万 Token”。第 1 档从 0 起，每档起点等于上一档终点，末档终点留空表示不封顶，最多 32 档。
修改档表后，已产生的账单不变。模型服务还可以针对某个授权对象单独配置阶梯价，见第 7.4 节。
5.3 参照目录模型定价
单个计价模式下，可以让模型售价跟随内置模型目录（models.dev 快照）中某个模型的公开价格。
- 在「编辑模型定价」中找到「参照目录模型」，从下拉候选中选择。候选按与当前模型名称的相似度排序。
- 选中后四项单价变为只读，并按“目录美元价 × 美元汇率”自动回填，不加价。
- 保存。列表的价格来源显示“参照 · 模型名”。
限制：
- 阶梯计价模式不支持参照，切换到阶梯计价会清除参照；
- 结算币种不是美元且未配置美元汇率时，页面提示“请先在全局设置配置美元汇率”；
- 选择「清除参照」恢复为手工填写的草稿。
5.4 按目录价批量填充
需要一次为某个供应商的大量模型填写售价时，使用目录价批量填充。
- 在「模型&定价」页签先选择一个供应商，再选择「按目录价填充」。进入填充模式后表格不可编辑。
- 核对每个模型的建议价和跳过原因，例如“目录无价”“非对话模型”“无变化（跳过）”。目录中没有价格的模型，可点击「选参照模型」改用第 5.3 节的方式定价。
- 选择应用，在「应用目录价建议？」对话框中设置：
- 「填充目标」：覆盖当前范围全部、只更新来自目录价的模型、只填充四项售价都为空的模型（默认覆盖全部）；
- 「加价系数」：售价 = 目录价 × 汇率 × 加价系数，范围 0.01～100，默认 1.00 表示按成本价；
- 汇率：结算币种不是美元时填写 1 美元兑结算币种的汇率，预填全局设置中的美元汇率。此处输入只用于本次换算，不回写全局设置。
- 确认后，平台为范围内每个模型写入一个新价格版本，结果摘要显示已写入的模型数。选择「完成」退出填充模式。
价格来源以徽标区分：“目录价”“参照 · 模型名”“手工”。
5.5 模型分类
模型分类决定模型广场左侧「分类」筛选中出现的分类及其包含的模型。
- 进入「管理控制台 → 搭建 → 模型供应商 → 分类管理」。
- 选择「新增分类」，平台生成默认名称，可直接重命名并选择分类图标。分类列表按「显示顺序」排列。
- 选中分类，在右侧选择「添加模型」，把模型加入该分类；选择「移除」取消关联。
- 删除分类只移除该分类及其与模型的关联，模型和模型服务不会被删除。
平台不预置分类，各租户按需建立。
5.6 分时计价
分时计价按请求所处的时段使用不同单价，适用于供应商按峰谷时段定价的模型（例如 DeepSeek 工作日 9:00–12:00、14:00–18:00 为高峰价，其余时间为空闲价）。
- 在「编辑模型定价」中选择「分时计价」。
- 选择「时区」，默认
Asia/Shanghai。时区随价格保存，与租户时区无关；有夏令时的时区按当地时钟换算。 - 在「基础价格」中填写未落入任何时段时使用的四项单价。
- 在「时段」中「添加时段」，每段填写「名称」（例如“高峰”）、开始与结束时间（24 小时制
HH:MM，结束时间可填24:00）、「适用日」和四项单价。最多 8 段。 - 保存。
规则：
- 按请求开始时间判定时段。一个 11:59 开始、12:01 结束的请求按 11:59 所在时段计价；该调用的费用仍计入请求结束时所在的统计周期。
- 只按星期几判定，不区分法定节假日和调休。供应商官方在节假日按空闲价收费时，平台在节假日仍按星期几对应的时段计价，与供应商账单可能不一致。
- 时段左闭右开：时段 9:00–12:00 包含 9:00，不包含 12:00。
- 结束时间早于开始时间表示跨零点（例如 22:00–02:00），凌晨部分按开始那天判定适用日：适用日为周五的 22:00–02:00 覆盖周五 22:00 至周六 02:00。
- 时段之间不能重叠，开始时间与结束时间不能相同，表单会就地报错。
- 分时只作用于四项 Token 单价；图片、音频等物理单位计价不分时。分时计价不能与阶梯计价同时使用。
- 金额预算的预占按基础价与各时段价中的最高价估算；按价格选路使用基础价。
「参照目录模型」中带有官方分时方案的模型（目前为 DeepSeek 的 deepseek-flash 与 deepseek-v4-pro）会显示方案预览。选用后按分时计价保存：基础价格为参照价，高峰时段价格为基础价格的 2 倍。
计价结果的查看位置：
- 「模型广场 → 模型详情 → 价格」列出各时段价格和基础价格，并标出当前时段；
- 调用日志的调用详情和模型服务「调用情况」的调用明细显示「计价时段」，例如“高峰（09:00–12:00）”或“基础价格”。