OpenAI API Usage 怎么看？项目用量、Token 与成本怎么查

官方资料（2026-10-29 核对）：OpenAI：Reviewing API usage and costs · 导出月度 Usage/Cost · Organization Costs API

三种查看方式分别解决什么问题

Usage Dashboard 实操步骤

1. 确认 Organization：登录 API Platform，先在组织选择器确认要查看的组织。多个 Organization 的 Usage 不会自动合并。
2. 进入 Usage：在侧栏打开 Usage Dashboard。看不到时先排查权限，而不是判断“没有流量”。
3. 选择 UTC 时间段：按今天、MTD、完整月份或自定义范围筛选；与本地日志比较前先换算成 UTC。
4. 使用 Usage 页自己的 Project 选择器：它与平台其他位置的 Project 选择相互独立。可以选择一个、多个或清空选择查看组织总量。
5. 选择 API capability：查看 Responses、Chat Completions 或其他能力，再按模型、用户、API Key 等维度分析。
6. 需要明细时导出：Activity data 用于活动分析，Cost data 用于成本和对账。

为什么 Project 筛选经常看错

Usage Dashboard 有自己的 Project 选择器，不会自动沿用你在 API Platform 其他页面当前选中的 Project。选错 Project 会让图表看起来为空；清空 Project 选择则显示整个 Organization 的数据。Project 名称相似时，应同时核对 Project ID。

Project Owner 身份也不一定拥有 Usage Dashboard 权限。官方说明需要 Organization Owner 或被授予 Usage Dashboard permission，并且组织的 Usage 可见性设置可能限制普通项目成员查看。

如何查看单次请求 Token

Responses API 与 Chat Completions 的字段名不同：

部分模型还会返回 cached input 或 reasoning Token 明细。可见文字长度不能完整代表实际 Token 消耗，成本分析应读取响应和 Usage Dashboard，而不是只按字符数估算。

// Responses API：记录数值，不记录 API Key 或敏感输入
const usage = response.usage;
console.log({
  input: usage?.input_tokens,
  output: usage?.output_tokens,
  total: usage?.total_tokens
});

流式请求为什么可能没有最终 usage

Chat Completions 流式请求需要设置 stream_options.include_usage=true。正常结束前会额外返回一个包含整次请求 usage 的 chunk；其他 chunk 的 usage 可能为空。如果连接在最终 chunk 前中断，本地日志可能拿不到最终 usage，但这不能证明请求没有消耗 Token，应回到 Usage Dashboard 核对。

Activity data 与 Cost data 怎么选

• Activity data：适合排查请求量、Token、模型、Project、用户、API Key、Batch 或 Service tier。
• Cost data：适合查看金额、Line item、Project 和月度成本明细。
• 完整月对账：选择 UTC 月初至月末，Cost data，按 Line item 分组，Projects 选择 All 或指定项目，再导出 CSV。
• 长时间范围：官方允许长时间导出，但大范围可能拆成多个文件，应全部下载后再汇总。

Usage 与账单对不上时怎么查

1. 确认导出与账单属于同一个 Organization；不同 Organization 不会合并展示。
2. 确认日期按 UTC，而不是浏览器或服务器本地时区。
3. 确认 Project 筛选没有遗漏，必要时清空筛选看组织总量。
4. 区分 Credit grants 和 Usage：余额变化、购买 Credits 与 API 活动不是同一个指标。
5. 检查是否有 Scale Tier。被套餐分配覆盖的用量可能大于零，但 Project 额外模型支出仍为零；Scale Tier 订阅成本归 Organization。
6. 把 Cost CSV 按 Line item 汇总后再与同一账期比较，不要把未结束的 MTD 与完整月账单直接比较。

使用 Costs API 做自动化报表

需要组织级自动化时，可调用 GET /v1/organization/costs，用 Unix 秒指定 start_time，按 Project、用户、Line item、API Key 或 API source 分组。当前成本桶以日为单位。该接口使用 Admin Key；不要把 Admin Key 当成普通应用推理凭证，也不要放进浏览器或客户端。

自动化报表应处理分页、has_more 和 next_page，保存 Project/API Key ID 与内部业务名称的映射，并避免记录完整密钥。

为什么 Usage 页面为空或看不到

生产环境建议记录哪些字段

• 请求时间（UTC）、Project ID、模型、API capability 与请求 ID。
• 输入、输出、总 Token，以及可用时的缓存输入和推理 Token。
• 内部用户/任务 ID、重试次数和最终状态，但不记录完整 API Key。
• 每日成本预算、Project spend limit 和异常增长报警。
• 部署环境标识，避免 Preview、测试和生产混在同一 Project。

Project 与 Organization 层级不清楚时，先阅读 Project 与 Organization 区别；余额不足看 API Credits；429 则转到 API 速率限制。

常见问题

字段不要混用：Responses 与 Chat Completions 的输出和 usage 读取方式不同；迁移端点前查看 Responses API 与 Chat Completions 区别，再建立可比成本基线。

结构化输出不等于零解析成本；上线前请结合 Structured Outputs 与 JSON mode 指南记录拒答、截断、Schema 错误和重试率。