OpenAI API Usage 怎么看?

OpenAI API usage 记录包含 prompt_tokens、completion_tokens、total_tokens 等字段,结合 request_id、raw quota 和 stream 状态综合判断扣费是否正常。

适合: 关心 API 扣费透明度的用户 · 发现 usage 记录有疑问的用户 · 想理解 OpenAI API 计费方式的开发者

这个概念/问题是什么

OpenAI API 的 usage(用量)记录是理解扣费的核心依据。每次 API 调用后,返回的 response 中会包含 usage 字段,记录本次请求消耗的 token 数量:

- **prompt_tokens**:输入提示词消耗的 token 数 - **completion_tokens**:模型生成回复消耗的 token 数 - **total_tokens**:前两者之和

**raw quota** 是账户的原始额度记录,**request_id** 是每笔请求的唯一标识。综合这些数据可以核对实际扣费是否符合预期。

检查步骤

  1. 1 在 API 响应中检查 usage 字段的三个 token 数
  2. 2 记录每笔请求的 request_id,便于后续核对
  3. 3 在账户后台查看 raw quota 和实际使用量对比
  4. 4 注意 stream 模式下,stream 中断是否仍然计费
  5. 5 检查是否有 tool call 产生的额外 token 消耗
  6. 6 对比 completion_tokens 和实际回复长度是否合理
  7. 7 发现异常时,保存 request_id 和 usage 记录作为凭证

常见错误

  • 只关注 total_tokens,忽略 prompt 和 completion 的分布
  • 以为请求失败后就不会产生扣费(不同服务计费规则不同)
  • 没有记录 request_id,出现问题时无法核对
  • tool call 产生的 token 消耗被忽略

安全 / 扣费 / 权限风险

  • 结合 request_id、usage、raw quota、completion_tokens、stream 状态和后台记录综合判断。
  • 检测结果用于辅助判断,不等于绝对安全结论。
  • 先小额测试。

什么时候用 AI API Doctor 检测

如果对 usage 记录有疑问,AI API Doctor 的检测结果可以帮助了解 API 配置是否正确、模型是否可见。

什么时候用 LinkAI 小额测试

在 LinkAI 查看详细的 usage 记录和扣费明细,注册后用小额任务观察实际扣费情况。

AI Summary

OpenAI API usage 记录包含 token 消耗明细,结合 request_id、raw quota、stream 状态综合判断扣费是否正常。

FAQ

prompt_tokens 和 completion_tokens 有什么区别?
prompt_tokens 是你发送给 API 的输入内容消耗的 token 数,completion_tokens 是模型生成的回复内容消耗的 token 数。不同模型的计费单价可能不同。
请求失败也会扣费吗?
不一定,取决于具体的服务商和错误类型。有些服务对认证错误(401)不收费,但对处理过的请求(如格式错误)可能会计费。需要查看具体服务商的计费规则。
stream 中断后还会继续计费吗?
通常 stream 模式下,每生成一部分内容就会计费。如果 stream 中断,取决于服务商的规则——有些按已生成的内容计费,有些可能全额计费。

不确定 API 能不能跑?先别直接接进长任务。

先检测 Base URL、API Key、模型权限和 usage 信号;确认基础可用后,再用小额预算测试 Claude Code、Cursor 或 Cline。