OpenAI API 用量怎么看？Token、Dashboard 与 CSV 导出说明
简答：看单次请求，读取 API 响应中的 usage；看项目或组织累计用量，登录 Platform 进入 Usage Dashboard；看月度明细，导出 Activity data 或 Cost data CSV；做日报、看板和告警，再使用 Usage API。Dashboard 和导出数据按 UTC 显示，组织、项目、权限或流式请求设置不一致，都可能让页面数字与本地日志暂时对不上。
定义：OpenAI API 用量是组织、项目、用户、模型或 API Key 在指定时间范围内产生的请求活动、Token 消耗及相关费用明细。
先判断：你应该在哪里查看用量
OpenAI API 用量不是只在一个页面查看。单次请求、累计活动、月度对账和自动化统计分别对应不同入口。先按目标选择路径，可以避免把额度记录、项目支出和单次 Token 混在一起。
| 想确认的问题 | 推荐入口 | 重点查看内容 |
|---|---|---|
| 某一次请求用了多少 Token | API 响应中的 usage | 输入、输出和总 Token |
| 某个项目本月用了多少 | Platform 的 Usage Dashboard | 组织、项目、用户、模型和日期范围 |
| 月度费用如何对账 | Usage 页面导出 Cost data | 费用、支出拆分和账单周期 |
| 需要请求活动明细 | Usage 页面导出 Activity data | 项目、用户、API Key、模型等维度 |
| 要做日报或自动化看板 | Usage API 与 Cost API | 时间桶、请求数、Token 和筛选条件 |
| 想看组织额度发放记录 | 组织的 Billing 页面 | 额度记录，不等同于 API 活动量 |
OpenAI 官方用量说明将仪表板、API 响应、导出数据和额度发放记录区分开来。简单记忆：单次看响应，累计看 Dashboard，对账看 CSV，自动化看 API。
登录 Usage Dashboard 查看累计用量
- 登录
platform.openai.com。 - 选择要核对的组织，再进入侧边栏中的 Usage。
- 选择报告周期或自定义日期范围。
- 使用 Usage 页面自己的项目选择器筛选一个、多个或全部项目。
- 如需查看用户维度，进入 API 功能中的 Responses 或 Chat Completions，选择用户并应用筛选。
- 如需观察每分钟 Token 数量，将用量数据的时间间隔设置为 1 分钟；这只适用于用量数据，不适用于账单数据。
官方说明显示，Usage Dashboard 需要组织所有者身份或相应用量仪表板权限。登录后看不到数据时，应先确认当前组织、日期范围和项目筛选，再检查账户权限。
Dashboard 使用 UTC 显示日期和时间。假如应用日志使用北京时间，比较某个跨日请求前，应先把日志转换为 UTC；否则同一请求可能被分到不同日期。
另外，Usage 页面有独立的项目选择器，它不一定跟平台其他位置当前选择的项目同步。要查看组织整体数据，应清除已选项目，而不是只选择某一个项目。
入口、权限和筛选规则可随平台页面调整，操作前可打开官方 API 用量和费用说明核对当前页面。
单次请求如何读取 Token 消耗
单次请求最直接的核对位置是 API 返回的 usage 对象。Chat Completions 和 Responses 的字段名不同，不能直接混用。
| 指标 | Chat Completions | Responses |
|---|---|---|
| 输入 Token | usage.prompt_tokens | usage.input_tokens |
| 输出 Token | usage.completion_tokens | usage.output_tokens |
| 总 Token | usage.total_tokens | usage.total_tokens |
Chat Completions 的响应结构可能包含：
{"usage":{"prompt_tokens":13,"completion_tokens":7,"total_tokens":20}}
上面的数字只是结构示例，不代表实际消耗。根据端点和模型不同，响应还可能包含缓存输入 Token、推理 Token 或其他用量字段。可见文本长度不能直接当成总 Token，因为系统提示、历史消息、工具调用、缓存输入和推理过程都可能影响最终统计。
Responses 的字段应按该次响应实际返回内容读取；如果程序只固定读取 prompt_tokens，可能会把 Responses 请求误判为没有 Token 用量。
工程上建议为每次请求保存请求 ID、模型、端点、开始和结束时间、HTTP 状态码以及非敏感的 usage 元数据，但不要把 API Key 写入日志。
流式请求没有 usage 怎么办
流式 Chat Completions 中，普通内容数据块的 usage 可能为空。需要在请求体中加入：
{"stream":true,"stream_options":{"include_usage":true}}
启用后，在 data: [DONE] 之前会出现一个额外数据块，其中包含整个请求的用量；该数据块的 choices 数组为空，其他数据块的 usage 通常为 null。
如果连接在最后一个用量数据块到达前中断，客户端可能收不到 usage。未收到最后一个数据块，不能证明该请求没有消耗 Token。官方说明还指出，这个配置仅适用于 Chat Completions。
排查时应确认三点：请求是否真的带有 stream_options.include_usage，客户端是否持续读取到结束块，以及流式解析器是否丢弃了最后一个空 choices 数据块。依据可查看OpenAI 官方流式用量说明。
Activity data 和 Cost data 怎么选
- 登录 Platform，选择相关组织或项目。
- 进入 Usage，打开日期范围选择器。
- 选择完整自然月，或使用 Month to date 查看当月至今。
- 点击 Export。
- 需要请求活动级明细时选择 Activity data；需要费用和支出拆分时选择 Cost data。
- 设置分组、项目、时间间隔和 CSV 格式后点击 Download。
| 导出类型 | 适合场景 | 常见维度 |
|---|---|---|
| Activity data | 分析请求活动和 Token 使用情况 | 项目、用户、API Key、模型、批处理、服务等级 |
| Cost data | 费用报告和月度账单核对 | 费用、支出类别、项目、Line item |
OpenAI 官方导出说明指出，导出日期可以选择完整自然月或 Month to date；生成较大文件可能需要等待，文件准备好后再下载。导出时间按 UTC 处理。
如果要按月核对费用，可以优先选择 Cost data、按 Line item 分组、使用 CSV 格式和按日时间间隔。若要查某个模型、用户或 API Key 的活动，则更适合选择 Activity data。
企业账单核对还要确认组织、发票对应周期和导出周期一致。官方资料显示，对于 2026 年 4 月 1 日起开具的企业发票，详细 API 成本不再直接列在发票中，而是通过导出流程提供；具体账单安排仍应以当前账户页面和官方通知为准。
Usage API 适合做自动化监控
如果你需要日报、项目看板、预算提醒或定时统计，手工打开 Dashboard 不够方便，可以使用 Usage API 和 Cost API。官方 Cookbook 示例展示了按时间桶查询用量，并按模型、项目、用户或 API Key 等维度筛选。
- 先确认当前账号和 API Key 具备相应用量查询权限。
- 设置明确的开始时间、结束时间和时间间隔。
- 按接口要求处理分页，避免只读取第一页。
- 保存组织、项目、模型、时间桶和原始返回值，再在报表层汇总。
- 将 Unix 时间戳统一转换为 UTC 后再展示本地时间。
- 把 API 查询失败、空结果和真实零用量分别记录，避免自动化报表把权限问题显示成零消耗。
官方示例涉及输入 Token、输出 Token、缓存输入 Token、请求数以及项目、用户、API Key 和模型等字段。接口路径、参数和权限要求应以当前文档为准，不建议凭旧代码推断。可参考OpenAI 官方 Usage API 与 Cost API 示例。
自动化查询使用的管理类凭据应放在环境变量或密钥管理系统中，不要提交到代码仓库，也不要在诊断命令中输出完整 Key。
Dashboard 和本地日志对不上时的排查清单
不要仅凭页面数字或某个状态码判断平台故障。按“组织→项目→时间→接口→流式→权限→数据延迟”的顺序核对：
- 组织：确认 Dashboard、API 请求、账单和发票属于同一个组织。不同组织的用量不会自动合并。
- 项目：检查 Usage 页面自己的项目选择器，确认没有遗漏项目或误选单个项目。
- 时间：把应用日志转换为 UTC，并确认结束日期覆盖了完整请求周期。
- 字段：Chat Completions 读取
prompt_tokens和completion_tokens；Responses 读取input_tokens和output_tokens。 - 流式：检查是否加入
include_usage，以及客户端是否读到了最后一个用量数据块。 - 权限：确认当前账户具备用量仪表板权限。能打开 Usage 不代表可以修改全部 Billing 设置。
- 数据类型：额度发放记录反映组织额度，API 用量反映 API 活动，两者不能直接相加。
- 生成延迟：CSV 导出文件可能需要生成时间，刚结束的请求暂时未出现在页面，也不能立即推断为零消耗。
如果仍然无法对齐，保留查询日期、组织、项目、模型、请求 ID、响应中的 usage 和导出文件参数，再向组织管理员或官方支持提交脱敏后的信息。
使用兼容接口时的核验边界
本文是第三方 AI API 接入指南站，不是 OpenAI 官方站点。直接调用 OpenAI API 时，应以对应 Platform 页面、API 响应和官方文档为准。
如果你通过 OpenAI 兼容接口、API Router 或其他中间层调用模型，中间层返回的字段、统计延迟和费用口径可能与 OpenAI 官方页面不同。建议分别保存原始响应、接口侧日志、服务商账单和官方用量记录，不要只凭某一侧的数字判断费用。
最小核对闭环是：单次请求看响应中的 usage，累计活动看 Usage Dashboard，月度明细导出 Activity 或 Cost CSV，自动化统计使用 Usage API；出现差异时优先检查组织、项目、UTC、权限和流式结束块。
常见问题
OpenAI API 用量在哪里看？
累计用量登录 Platform 后进入 Usage Dashboard；单次请求查看 API 响应中的 usage；月度明细在 Usage 页面导出 Activity data 或 Cost data；需要自动化报表时使用 Usage API。
为什么 Dashboard 日期和我的日志对不上？
官方 Dashboard 和导出数据使用 UTC。先把应用日志转换为 UTC，再检查组织、项目筛选、日期范围和请求是否跨日。
Chat Completions 和 Responses 的 Token 字段一样吗？
不一样。Chat Completions 通常读取 prompt_tokens 和 completion_tokens；Responses 通常读取 input_tokens 和 output_tokens；两者都可能返回 total_tokens。
流式请求没有 usage，是否代表没有消耗 Token？
不是。Chat Completions 流式请求需要加入 stream_options.include_usage。如果连接在最后一个用量数据块前中断，客户端可能收不到 usage，但不能据此证明没有消耗。
Activity data 和 Cost data 应该导出哪个？
要分析请求活动、模型、项目或 API Key 时选择 Activity data；要核对费用和支出拆分时选择 Cost data。月度对账还要确认组织和 UTC 周期一致。
看不到 Usage 或 Billing 页面怎么办？
先确认登录的是正确组织并检查筛选条件。Usage Dashboard 需要组织所有者或相应用量仪表板权限；部分 Billing 设置还需要额外的组织权限，应联系组织所有者核对。
常见问题
OpenAI API 用量在哪里看？
累计用量登录 Platform 后进入 Usage Dashboard；单次请求查看响应中的 usage；月度明细在 Usage 页面导出 Activity data 或 Cost data；自动化统计使用 Usage API。
为什么 Dashboard 日期和日志对不上？
Dashboard 和导出数据使用 UTC。把应用日志转换为 UTC 后，再检查组织、项目筛选、日期范围和跨日请求。
Chat Completions 和 Responses 的 Token 字段一样吗？
不一样。Chat Completions 通常读取 prompt_tokens 和 completion_tokens；Responses 通常读取 input_tokens 和 output_tokens；两者都可能返回 total_tokens。
流式请求没有 usage，是不是没有消耗 Token？
不是。Chat Completions 流式请求需要加入 stream_options.include_usage。若连接在最后一个用量数据块前中断，客户端可能收不到 usage，但不能据此证明没有消耗。
Activity data 和 Cost data 选哪个？
分析请求活动、模型、项目或 API Key 时选 Activity data；核对费用和支出拆分时选 Cost data。月度对账还要确认组织和 UTC 周期一致。
看不到 Usage 或 Billing 页面怎么办？
先确认组织和筛选条件。Usage Dashboard 需要组织所有者或相应用量仪表板权限；部分 Billing 设置还需要额外组织权限，应联系组织所有者。