> 原始 Markdown 孪生体（构建期从源 Markdown 生成）。渲染页：https://docs.gatellm.io/zh-CN/howto/setup-pricing-and-billing · 文档索引：https://docs.gatellm.io/zh-CN/llms.txt


# 配置模型定价与查看月度成本

设置页的**计费**子页签下有两个页签：**模型价格**（模型定价快照）和**月度成本**（按月费用拆解）。设置页另一个子页签是**用户与访问**（用户及密钥管理，详见 [访问密钥与密钥组字段](/zh-CN/reference/access-keys-groups-fields.md) 与 [控制台用户管理](/zh-CN/console/user-management.md)）。

入口：控制台 → **设置** → **计费**（admin、monitor 可见）。

## 模型定价

管理每个模型的价格快照（per 1M tokens，单位 USD）。价格用于月度成本的费用计算。

### 模型列表

表格列出所有已配置的模型，每行显示模型名、所属上游、快照数量。点击展开查看该模型的价格历史。

### 快照

每个模型可有多条价格快照，按时间排列：

| 列 | 说明 |
|----|------|
| 创建时间 | 快照生效时间（悬浮显示价格有效区间） |
| 计费模式 | Token 计费 / 按次计费 / 按时长计费 |
| 输入价格 | 每 1M 输入 token 的 USD 价格 |
| 输出价格 | 每 1M 输出 token 的 USD 价格 |
| 缓存读取价格 | 每 1M 缓存读取 token 的 USD 价格 |
| 模式单价 | 按次/按时长计费模式下的模式价格（按次=每次调用，按时长=每秒媒体时长；Token 模式显示 —） |
| 来源 | auto（系统从内置基线或远程定价源自动写入）或 pinned（控制台手动设置，黄色徽章） |
| 状态 | current（当前生效，绿色）或 preset（预设/历史） |

### 新建 / 编辑快照（仅 admin）

1. 展开目标模型，点「新建快照」。
2. 填写：
   - **创建时间**：留空=当前时间，或指定过去/未来时间（格式 `YYYY-MM-DD HH:MM:SS`）。过去时间=回填历史价格，未来时间=预设将来生效。
   - **输入/输出/缓存读取价格**：USD / 1M tokens。
   - **计费模式**：Token 计费（默认）、按次计费或按时长计费。
   - **币种**：默认 USD，可选 CNY / EUR / JPY / GBP。
   - **按次价格**：仅按次计费模式下填写。
   - **时长单价**：仅按时长计费模式下填写（每秒媒体时长价格；适用于语音/视频等不返回 token 用量、只返回时长秒数的模型）。
   - **额外定价**：键值对形式的自定义定价维度（如 `reasoning_tokens`）。
3. 保存。

### 价格生效规则

- 多条快照按 `created_at` 排序，每条覆盖 `[自身时间, 下一条时间)` 区间。
- 最早的快照向前覆盖所有历史时段（回填）。
- 最新的快照向后无限延伸（当前及未来生效）。
- `is_current` 标记当前时刻生效的那条。
- **auto 与手动价的关系**：当你为某模型手动新建/编辑一条价格快照（pinned）时，它因时间更新而自动成为当前生效价，**遮蔽**其下所有 auto 行——auto 行不会被删除或覆盖，而是作为历史快照保留在表里、成本计算走 pinned 价不受影响。pinned 价是权威的，系统刷新时会跳过该模型，不会用基线价去覆写你的手动价。
- **auto 行如何更新**：当某模型只有一条 auto 快照（你还没建过 pinned 价）时，若内置基线或远程定价源价格变化，系统会**原地更新**这一条（保持一行，而非每改一次基线就追加一条）。一旦你为该模型添加过第二条快照（产生了价格历史），auto 的后续变化才会追加新行，以保留审计轨迹。
- **删掉 pinned 价**：当前价回退到次新的 auto 行；若此时该模型只剩一条 auto 行且基线已更新，系统会原地更新它到最新值，自愈。

字段语义的完整参考见 [定价与计费字段](/zh-CN/reference/pricing-and-billing-config.md)。

## 月度成本

按月拆解费用，支持五个维度：访问密钥、密钥组、模型、按天、按周。按天 / 按周以**浏览器本地时区**切分（周行为本地时区的周一至周日），表格按时间先后排列。

### 操作

1. 选维度（默认访问密钥）与月份（下拉，范围由统计数据的起止时间决定）。
2. 顶部汇总卡片显示所选月份：总请求数、总费用、输入 token、输出 token、缓存读取 token。
3. 主表按所选维度列出：

| 列 | 说明 |
|----|------|
| 访问密钥 / 密钥组 / 模型 / 天 / 周 | 可展开查看明细；周显示为该周的日期范围（MM-DD ~ MM-DD） |
| 总请求数 | |
| 成功请求 | |
| 错误请求 | 大于 0 时红色显示 |
| 输入 token | |
| 输出 token | |
| 缓存读取 token | |
| 费用 (USD) | |

4. 展开某行：访问密钥 / 密钥组维度显示该项下各模型的请求数与费用明细；模型维度显示消费该模型的各访问密钥明细；按天 / 按周维度显示该时段内各模型的分布明细。
5. 表尾有合计行。
6. 点导出按钮把当前显示月的账单导出为 Excel，详见 [导出账单 Excel 与日志排查](/zh-CN/howto/billing-export-and-logs.md)。

## 常见问题

**Q：价格快照的来源 auto 和 pinned 有什么区别？**
auto 是系统从内置基线或远程定价源自动写入的价格；pinned 是你在控制台手动设置或修改的价格。pinned 因时间更新成为当前生效价、遮蔽其下的 auto 行，且系统刷新时跳过该模型不会覆写 pinned 价。

**Q：我设置了手动价，之前 auto 写入的那条会怎样？**
不会被删除或覆盖。它被你的手动价遮蔽（成本计算走手动价），作为历史快照与回退点留在表里。删掉手动价后，当前价自动回退到它。

**Q：只有一条 auto 价格时，基线价变了会追加新行吗？**
不会。系统会原地更新那唯一一条，表始终保持一行。只有当已存在第二条快照（你建过 pinned 价或回填过历史价）后，基线变化才会追加新行以保留价格历史。

**Q：删除快照会怎样？**
- 只剩一条时删除：模型变为「无定价」，刷新后系统可能重新自动获取。
- 删除当前生效的那条：回退到相邻快照。
- 删除历史记录：永久删除，不影响当前定价。

**Q：月度成本的费用不准？**
确认模型定价的快照时间范围是否覆盖了该月份。若某月没有有效价格，费用为 0。

**Q：三种计费模式有什么区别？**
Token 计费按输入/输出 token 数计价；按次计费按调用次数计价（每次固定价格）；按时长计费按媒体时长计价（单价 × 秒数）。三种模式互斥，每种模式忽略其余模式的价格。按次/按时长适用于不返回 token 用量的模型（如图片、语音转写、视频生成）。

**下一步**：[定价与计费字段](/zh-CN/reference/pricing-and-billing-config.md) 看完整字段语义；[统计](/zh-CN/console/statistics.md) 看用量统计；[导出账单 Excel 与日志排查](/zh-CN/howto/billing-export-and-logs.md) 看导出操作；[上游与模型字段](/zh-CN/reference/upstreams-models-fields.md) 看模型配置。