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

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

如果你正在处理 OpenAI API 计费对账单，这份字段映射清单能帮你快速识别每一条日志里的 token 使用情况、缓存命中次数和 Prompt 缓存价格。适用人群是所有 OpenAI 官方 API 用户，特别是那些用 ChatGPT Plus 试用订阅 + 官方 API 混合模式的人。决策方法：每次导出 usage 后，先用这张表逐字段检查，避免漏算缓存优惠或错算非官方渠道。建议配合 官方 API 计费对照站 的实时数据页，做最终 $/M 确认。

OpenAI 作为官方 API 计费对照站，这里用精确的英文术语保留一切关键概念，确保你能直接对标官方记录。

核心概念与术语

• usage log：OpenAI 官方 API 提供的完整计费日志文件。
• $ / M tokens：官方 GPT Token 单价（以百万 tokens 为单位）。
• Prompt 缓存价格：开启 Prompt 缓存功能时，命中缓存的部分享受优惠计费。
• ChatGPT Plus 试用订阅：OpenAI 平台上的 Plus 级订阅，用于测试官方 API 限额。
• 非官方账号切换工具：第三方平台切换 OpenAI 账号时产生的记录，不属于官方计费范围。

决策表：OpenAI 官方计费字段对照

导出字段示例	含义说明	是否计入官方 $ / M tokens	备注
id	日志唯一标识	N/A（非计费）	仅用于关联
created_at	计费发生时间	N/A（非计费）	辅助审计
model	调用模型（如 gpt-4o）	需查模型页	关键
object	始终为 "chat.completion"	N/A（非计费）	结构化信息
`usage.prompt_tokens**	请求 token 总数	是（基础）	必须核对
usage.completion_tokens	回复 token 总数	是（基础）	必须核对
usage.total_tokens	prompt + completion 总和	是（基础）	基础总计
cost	官方估算花费（美元）	是（直接对应）	最终验证值
prompt_cache_read_tokens	命中 Prompt 缓存的 tokens	是（优惠价）	区分缓存价格
prompt_cache_write_tokens	写入 Prompt 缓存的 tokens	是（写入价格）	区分缓存价格

数据来源：OpenAI 官方 API 计费对照站实时字段说明，建议点击 官方 API 计费对照站 对应模型页面核对。

实操清单：分步可核对

1. 登录 官方 API 计费对照站 获取最新模型价格表。

2. 导出 usage 日志（平台导出按钮）。

3. 导入到电子表格（Excel / Google Sheets）。

4. 按 model 字段分组，逐条匹配对应模型的 $ / M tokens。

5. 计算每条记录的预期花费 = usage.total_tokens / 1,000,000 × 模型单价。

6. 检查 cost 字段是否与计算结果一致。

7. 单独统计 prompt_cache_read_tokens 与 prompt_cache_write_tokens，加总后按缓存价格乘以单价。

8. 对比 cost 与总和，确认无遗漏。

9. 对比 ChatGPT Plus 试用订阅 的限额记录，确保 token 使用未超出。

10. 最终对比 官方 API 计费对照站 的 $ / M tokens 数据页，锁定最终账单。

常见坑与风险边界

导出字段可能因平台更新或地区差异导致显示不全，建议以官方/挂牌页当日数据为准。混合使用非官方账号切换工具时，日志中无 cost 字段，容易错认成本。Prompt 缓存功能在部分地区未上线时，相关字段会缺失。升级至更高 Plan 后，旧日志字段可能不兼容，建议升级后必挂清理。

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

• 官方 API 计费对照站：实时模型价格与字段说明
• 官方价格页：$ / M tokens 完整对照
• API 过渡页：跨平台计费平滑过渡指南
• 计费路径：完整对账流程图
• 示例页：完整 usage 日志对照案例
• 指南页：详细字段解析与模板

延伸阅读

• API 过渡指南：如何用官方计费工具平滑切换平台
• 官方 API 计费对照站：实时价格与字段对照
• 官方价格页：$ / M tokens 完整数据
• 指南页：字段映射与对账模板下载