定价与计费字段
设置页包含两个子页签:计费(模型定价 + 月度账单)和用户与访问(用户及密钥管理,详见 访问密钥与密钥组字段 与 控制台用户管理)。
入口:控制台 → 设置(admin、monitor 可见)。UI 操作视角的步骤见 配置模型定价与查看月度账单。
模型定价 — 快照字段
每个模型可有多条价格快照,按时间排列:
| 列 | 说明 |
|---|---|
| 创建时间 | 快照生效时间(悬浮显示价格有效区间) |
| 计费模式 | Token 计费 / 按次计费 / 按时长计费 |
| 输入价格 | 每 1M 输入 token 的 USD 价格 |
| 输出价格 | 每 1M 输出 token 的 USD 价格 |
| 缓存读取价格 | 每 1M 缓存读取 token 的 USD 价格 |
| 模式单价 | 按次/按时长计费模式下的模式价格(按次=每次调用,按时长=每秒媒体时长;Token 模式显示 —) |
| 来源 | auto(系统从内置基线或远程定价源自动写入)或 pinned(控制台手动设置,黄色徽章) |
| 状态 | current(当前生效,绿色)或 preset(预设/历史) |
| 币种 | 默认 USD,可选 CNY / EUR / JPY / GBP |
| 额外定价 | 键值对形式的自定义定价维度(如 reasoning_tokens) |
价格生效规则
- 多条快照按
created_at排序,每条覆盖[自身时间, 下一条时间)区间。 - 最早的快照向前覆盖所有历史时段(回填)。
- 最新的快照向后无限延伸(当前及未来生效)。
is_current标记当前时刻生效的那条。- auto 与手动价的关系:当你为某模型手动新建/编辑一条价格快照(pinned)时,它因时间更新而自动成为当前生效价,遮蔽其下所有 auto 行——auto 行不会被删除或覆盖,而是作为历史快照保留在表里、成本计算走 pinned 价不受影响。pinned 价是权威的,系统刷新时会跳过该模型,不会用基线价去覆写你的手动价。
- auto 行如何更新:当某模型只有一条 auto 快照(你还没建过 pinned 价)时,若内置基线或远程定价源价格变化,系统会原地更新这一条(保持一行,而非每改一次基线就追加一条)。一旦你为该模型添加过第二条快照(产生了价格历史),auto 的后续变化才会追加新行,以保留审计轨迹。
- 删掉 pinned 价:当前价回退到次新的 auto 行;若此时该模型只剩一条 auto 行且基线已更新,系统会原地更新它到最新值,自愈。
计费模式
| 模式 | 说明 |
|---|---|
| Token 计费(默认) | 按输入/输出 token 数计价 |
| 按次计费 | 按调用次数计价(每次固定价格),适用于不返回 token 用量的模型 |
| 按时长计费 | 按媒体时长计价(时长单价 × 秒数),适用于语音转写、视频生成等只返回时长、不返回 token 用量的模型。时长秒数逐请求采集进用量扩展字段(whisper/fun-asr 为 duration,视频生成为 video_duration) |
月度账单 — 字段
按月、按访问密钥拆解费用。顶部汇总卡片显示所选月份:总请求数、总费用、输入 token、输出 token、缓存读取 token。
主表按访问密钥列出:
| 列 | 说明 |
|---|---|
| 访问密钥 | 可展开查看模型明细 |
| 总请求数 | |
| 成功请求 | |
| 错误请求 | 大于 0 时红色显示 |
| 输入 token | |
| 输出 token | |
| 缓存读取 token | |
| 费用 (USD) |
展开某行,显示该密钥下各模型的请求数和费用明细。表尾有合计行。
定价来源
价格 auto 行有两个来源:
- 内置定价基线(随网关程序内置,无需配置)
- 远程定价源(在官方镜像中未开放为环境变量;有需要请联系支持)
常见问题
Q:价格快照的来源 auto 和 pinned 有什么区别? auto 是系统从内置基线或远程定价源自动写入的价格;pinned 是你在控制台手动设置或修改的价格。pinned 因时间更新成为当前生效价、遮蔽其下的 auto 行,且系统刷新时跳过该模型不会覆写 pinned 价。
Q:我设置了手动价,之前 auto 写入的那条会怎样? 不会被删除或覆盖。它被你的手动价遮蔽(成本计算走手动价),作为历史快照与回退点留在表里。删掉手动价后,当前价自动回退到它。
Q:只有一条 auto 价格时,基线价变了会追加新行吗? 不会。系统会原地更新那唯一一条,表始终保持一行。只有当已存在第二条快照(你建过 pinned 价或回填过历史价)后,基线变化才会追加新行以保留价格历史。
Q:删除快照会怎样?
- 只剩一条时删除:模型变为「无定价」,刷新后系统可能重新自动获取。
- 删除当前生效的那条:回退到相邻快照。
- 删除历史记录:永久删除,不影响当前定价。
Q:月度账单的费用不准? 确认模型定价的快照时间范围是否覆盖了账单月份。若某月没有有效价格,费用为 0。
Q:三种计费模式有什么区别? Token 计费按输入/输出 token 数计价;按次计费按调用次数计价(每次固定价格);按时长计费按媒体时长计价(单价 × 秒数)。三种模式互斥,每种模式忽略其余模式的价格。按次/按时长适用于不返回 token 用量的模型(如图片、语音转写、视频生成)。
下一步:配置模型定价与查看月度账单 看 UI 操作步骤;统计 看用量统计;环境变量配置参考 看全部环境变量。
