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


# 定价与计费字段

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

入口：控制台 → **设置**（admin、monitor 可见）。UI 操作视角的步骤见 [配置模型定价与查看月度成本](/zh-CN/howto/setup-pricing-and-billing.md)。

## 模型定价 — 快照字段

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

| 列 | 说明 |
|----|------|
| 创建时间 | 快照生效时间（悬浮显示价格有效区间） |
| 计费模式 | Token 计费 / 按次计费 / 按时长计费 |
| 输入价格 | 每 1M 输入 token 的 USD 价格 |
| 输出价格 | 每 1M 输出 token 的 USD 价格 |
| 缓存读取价格 | 每 1M 缓存读取 token 的 USD 价格 |
| 音频输入价 / 音频输出价 | 每 1M 音频 token 的价格；留空则音频按普通输入/输出价计。**仅按 Token 计费时生效** |
| 模式单价 | 按次/按时长计费模式下的模式价格（按次=每次调用，按时长=每秒媒体时长；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 | |
| 费用 | **按快照币种分别显示**（per-currency 明细，各币种各一行），不是固定 USD 列 |

展开某行，显示该密钥下各模型的请求数和费用明细。表尾有合计行。

> **币种与折算**：成本在计算时**按快照自身币种计**，不做自动换算——快照是 CNY 就按 CNY 计，是 USD 就按 USD 计。账单因此按币种拆开展示；若某条目含多个币种，会额外给一个「≈ 目标币种」的约计合计，用汇率（优先 API 汇率、离线时用本地汇率，均带日期）折算。**混合币种聚合是已知限制**：折算只是展示层约计，想要精确的单一币种账单，请保持每个模型的定价币种一致。

## 定价来源

价格 auto 行有两个来源：
- 内置定价基线（随网关程序内置，无需配置）
- 远程定价源（在官方镜像中未开放为环境变量；有需要请联系支持）

## 常见问题

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

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

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

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

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

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

**下一步**：[配置模型定价与查看月度成本](/zh-CN/howto/setup-pricing-and-billing.md) 看 UI 操作步骤；[统计](/zh-CN/console/statistics.md) 看用量统计；[环境变量配置参考](/zh-CN/reference/configuration.md) 看全部环境变量。