导出 usage 日志做二次对账：字段映射清单

All guides · Full article is primarily Simplified Chinese; use the English summary below for quick takeaways (GEO-friendly).

导出 usage 日志做二次对账：字段映射清单

导出 OpenAI usage 日志做二次对账是很多订阅用户和开发者在对账单不清晰时最实用的方法。通过日志中记录的 Token 消耗和 prompt cache 命中率，可以精确复现官方单价并算出每个模型的真实 $/M 成本。这适用于 ChatGPT Plus 用户想确认是系统级消耗还是自定义 Prompt 缓存引起费用异常的开发者，以及需要独立于 OpenAI 官方账单的二次验证场景。

谁适用？

如果你在 OpenAI 官方 API 计费页面看到 GPT Token 单价 和 Prompt 缓存价格 数据，但账单明细对不上，或者想区分 Plus 订阅与 API 纯使用场景，就需要这份字段映射清单。

怎么决策？

1. 先在 OpenAI 控制台下载 usage logs（导出格式为 JSON/CSV）。

2. 用以下字段对照表核对对应字段。

3. 计算公式：总 Token 消耗 ÷ 模型单价（官方挂牌页或缓存价格）= $/M。

结果与账单一致则说明数据来源正确；不一致则需联系 OpenAI 支持。

核心概念与术语

usage logs：OpenAI 平台导出的详细日志文件，记录每次 API 调用或 ChatGPT Plus 使用记录。
Token：OpenAI 官方计费的最小单位，1 Token 通常对应约 4 个英文字符或 3 个中文字符。
prompt cache：OpenAI 推出的 Prompt 缓存功能，命中后会按 Prompt 缓存价格 计算费用，避免重复 Prompt 的重复处理消耗。
$/M tokens：每百万 Token 的费用标准，官方 API 价格表会明确标注。
ChatGPT Plus：OpenAI 的订阅计划，包含一定量的免费 Token，超出部分按 GPT Token 单价 收费。
API：通过 API 调用模型的开发者模式，费用完全独立于 Plus 订阅。

决策表 / 对照表

OpenAI 官方计费表字段	usage logs 实际字段示例	用途与决策建议	对应单价参考
model	`"model": "gpt-4o"`	核对模型名称，确保与账单一致	gpt-4o: $2.5/M (官方标准)
prompt_tokens	`"prompt_tokens": 1234`	计算输入 Token 消耗	同上
completion_tokens	`"completion_tokens": 567`	计算输出 Token 消耗	同上
cache_created_tokens	`"cache_created_tokens": 890`	确认是否命中缓存	缓存价格通常更低（约 0.2-0.5$/M）
cache_read_tokens	`"cache_read_tokens": 450`	计算缓存命中 Token	参考官方缓存价格
total_tokens	`"total_tokens": 2101`	快速汇总总消耗	可直接用于二次对账
object	`"object": "chat.completion"`	确认调用类型	—

注：字段名称可能随平台更新略有差异，以官方文档或账单中的 官方 API 计费 为准。建议直接在 OpenAI 控制台设置页面的 usage logs 导出页面查看当前字段列表。

实操清单：分步可核对

1. 登录 OpenAI 平台：进入官方 API 控制台，在 Usage 页面点击 Export logs（或直接在 Billing > Usage logs 找到导出按钮）。

2. 下载并解析文件：选择 JSON 或 CSV 格式，保存到本地。

3. 打开对照表：复制上表字段，对应日志中的每行数据。

4. 分组统计：分别统计 prompt_tokens、completion_tokens、cache_* 字段总和。

5. 计算成本：

- API 模式：总 Tokens ÷ 模型单价（从官方 API 价格下载的表格）

- Plus 订阅：超出部分 Token ÷ GPT Token 单价（通常 $0.01–$0.03/M，实际以账单为准）

6. 比对账单：把计算结果与 OpenAI 账单总金额对比，若误差 <1% 则为正确映射。

7. 备份与记录：保存所有日志及计算 Excel 表，便于下次复用。

提示：如果使用 Claude Code 或第三方工具调用 OpenAI 模型，也可用此清单快速对账。

常见坑与风险边界

字段命名不一致：不同模型或不同调用方式（stream vs non-stream）可能缺少 cache_read_tokens 字段，导致缓存命中计算错误。
Plus vs API 混淆：Plus 用户的免费额度与 API 模式完全独立，日志中若同时出现两者数据需单独分开统计。
缓存命中率过高：命中率超过 80% 时，实际消耗会远低于官方 ChatGPT API 多少钱 标准，容易被误判为“免费”。
导出文件过大：使用时间超过 30 天可能文件 >50MB，影响解析速度。
模型更新：如 OpenAI 发布新模型，日志字段可能新增，需及时对照最新官方 API 计费。

重要提醒：以上仅供参考，非法律意见声明。数据以 OpenAI 官方/挂牌页当日数据为准，所有二次对账仅供个人学习与内部核对，实际计费以 OpenAI 平台最终账单为准。

站内路径：相关工具与页面

OpenAI 官方 API 计费对照站：查看完整 GPT Token 单价 和 Prompt 缓存价格 表。
官方 API 价格页面：获取实时模型单价数据。
API 流量中转工具：帮助开发者更高效计算复杂场景下的 $/M。
计费路径与账单查询：详细讲解如何导出并解读 usage logs。
OpenAI API 使用指南：包含完整实操步骤与常见误区。

导出 usage 日志做二次对账：字段映射清单