OpenAI
页面内容为机器翻译。查看英文原文。

查看 API 用量和费用

在分析中查看 API 活动,检查 API 响应中的 Token 数,并了解项目筛选条件、导出和规模层级费用。

更新于:yesterday

概览

你可以通过以下两种方式查看 API 用量:

  • 通过分析 > 用量查看当前和以往报告周期内的 API 活动。

  • 读取 API 响应中的用量信息,以检查单个请求。

Playground 使用的 API 调用与你的应用相同。其中消耗的 Token 会计入你账户的 API 用量,并遵循相同的使用规则和定价。

仪表板访问权限

您必须是组织所有者或拥有用量仪表板权限,才能访问用量仪表板。

在仪表板中查看用量

在 API 平台中,打开分析并选择用量,以查看当前项目。要查看整个组织的报告,请选择组织分析。选择要查看的报告周期,并在项目分析和组织分析之间切换后再次确认。

仪表板数据以 UTC 时间显示。将仪表板中的活动与应用日志进行比较时,请注意该时区。

近期用量可能需要一段时间才会显示在仪表板中。如果未显示近期活动,请稍后再查看。

筛选用量

在项目分析中,用量仅限于所选项目。在组织分析中,使用项目选择要查看的项目。所有项目包含组织中的每个项目,但仍受已选其他筛选条件的限制。

使用筛选条件,按 API 来源、API 密钥、模型、用户或处理层级缩小用量范围。在 API 来源中,可选择所有 API 来源、Agents API 或直接 API。

逐项移除所选条件,或选择清除筛选条件以重置筛选条件面板。清除筛选条件不会在项目分析和组织分析之间切换。

使用用量图表上的筛选,按批处理进行筛选。选择重置图表筛选条件,即可重置该图表的筛选条件。

如果某项功能不支持所选筛选条件,其数值可能无法显示。数值不可用并不表示用量为零。

如果某个筛选条件显示权限错误,你可能无权访问其中的选项。这并不表示没有记录到用量。

查看单个用户的用量

  1. 在要查看的项目或组织分析视图中,打开用量。在 API 功能表格中,选择 Responses 和 Chat Completions 对应的查看。

  2. 在筛选条件中,选择用户,然后选择相应用户。结果会立即更新。

  3. 查看该用户的图表和表格。

要查看某个用户在各项功能中的用量,请在用量概览中应用用户筛选条件。要比较不同用户,请清除该筛选条件,然后选择表格中的用户选项卡。

按天、小时或分钟查看 Token 数

如果用量中提供时间间隔控件,可选择 1 天或 1 小时,按天或小时查看 Token 数;也可选择 1 分钟,查看每分钟 Token 数(TPM)。选择自动,让仪表板根据报告周期选择时间间隔。这些时间间隔适用于用量数据,不适用于计费数据。

如果 1 分钟选项已禁用,请选择较短的报告周期,或使用框选缩放并在图表上拖动以缩小范围。然后选择 1 分钟。按 Esc 取消缩放框选。选择分析工具栏中的当前日期范围,即可选择其他报告周期。

查看用量图表和表格

使用指标选择一个或多个数据系列并同时显示,包括输入 Token、未缓存的输入 Token、已缓存的输入 Token、写入缓存的输入 Token、输入音频 Token、输出 Token和输出音频 Token。可用指标因功能而异。通过图例识别各个数据系列。

使用分组依据,按可用的类别(如项目、用户或模型)对用量进行分组。筛选条件决定包含哪些用量数据,分组方式决定如何显示这些数据。在折线图和柱状图之间切换,以查看趋势或比较各个类别。

使用用量表格中的选项卡查看各类明细。表格会显示每一行的相关指标,例如请求数、输入和输出 Token 数,或特定功能的计量单位。

在 API 功能中,选择某项功能对应的查看,以打开其详细图表和明细。Responses 和 Chat Completions 包含单独的 Token 和请求图表,以及模型请求指标。其明细选项卡使用与概览相同的维度,但不包含 API 功能选项卡。使用面包屑导航中的用量返回概览。

选择分组依据选项后,图表可能会将其余类别合并到其他中。如果图例中出现其他,选择该标签即可查看其中包含的类别及其用量。

选择对比仪表板,即可并排查看同一报告周期内的用量和另一个仪表板。使用左侧仪表板和右侧仪表板选择视图。如果所选时间间隔不适用于这两个仪表板,视图会切换为自动。选择退出对比返回仪表板。

排查来源不明的用量

如果用量中显示的活动无法与应用日志中的请求对应,请进行以下检查:

  1. 确认组织、项目范围和报告周期。将仪表板时间戳与应用日志进行比较时,请使用 UTC 时间。

  2. 打开相关项目的项目视图,或在组织分析的项目下选择该项目。然后使用筛选条件,按 API 密钥和模型缩小用量范围,并选择较短的报告周期。

  3. 将这些活动与同一周期、同一项目和同一 API 密钥的日志进行比较。检查日志是否涵盖使用该密钥的所有应用或集成。

  4. 如果多个应用或集成共用同一个项目或 API 密钥,仅凭总量可能无法确定请求来自哪一个应用或集成。将仪表板数据与各个应用在同一 UTC 时间段内的记录进行比较。

  5. 如果仍无法确定用量来源,请联系 OpenAI 支持团队,并提供相关的 UTC 时间段、组织和项目 ID、API 密钥标识符,以及相关截图或日志。如有请求 ID,也请一并提供。请勿提供 API 密钥的秘密值。

导出用量数据

要导出用量,请选择分析工具栏中的导出 CSV 图标,然后选择活动数据。

  1. 选择 API 功能和一个或多个分组依据维度。

  2. 检查 API 来源、项目、用户、API 密钥和模型。项目和 API 来源会沿用分析中的选择;请在对话框中选择其他导出筛选条件。

  3. 选择文件格式、开始时间、结束时间和时间间隔,然后选择下载。所选日期涵盖完整的 UTC 自然日。

可查看和导出的活动及费用数据范围为一年前的今天 UTC 00:00 至今。如需更早的数据,请联系 OpenAI 支持团队。按日统计的数据以每 31 天一个文件的形式导出。

有关月度发票核对和明细项目导出,请参阅:导出每月用量明细。

如果导出的活动数据中包含负值行,请比较单位、分组和日期均相同的行。请通过费用数据查看计费金额。仅凭活动数据中的负值行,无法确定发票金额是否已获抵扣。

查看支出

打开分析并选择支出,以查看当前项目的费用。要查看整个组织的费用,请选择组织分析,然后选择支出。

比较费用与用量前,请检查当前日期范围和筛选条件。用量和支出提供的筛选条件不同;某个仪表板中可用的筛选条件可能不适用于另一个仪表板。

使用 API 来源、API 密钥、模型和明细项目缩小支出范围。在组织分析中,使用项目选择要查看的项目。使用表格中的明细项目、API 密钥、用户、项目和模型选项卡查看各类明细。

支出限额数值不可用,并不表示限额为零,也不表示已应用新的限额。访问权限受限、未设置限额或请求失败,都可能导致仪表板无法显示数值。

查看服务运行状况

如果你的组织有权访问服务运行状况,可在分析中打开该仪表板以查看 API 性能。有关访问资格和指标定义,请参阅:排查 API 错误和延迟。

查看获赠额度

你可以在组织的账单页面查看获赠额度详情。

获赠额度和 API 用量反映的信息不同:获赠额度显示与组织关联的额度,而用量显示组织的 API 活动。

查看规模层级的用量和费用

如果您的组织已启用规模层级,并且您拥有所需的访问权限,请打开规模层级用量页面查看详细用量。

规模层级套餐费用归入组织,而非各个项目。

用量大于零,但项目支出为零

检查模型用量是否包含在你的规模层级配额内。如果该模型的所有用量都在规模层级 TPM 配额内,项目可能会显示有用量,但没有额外的模型支出。

规模层级订阅费用仍计入组织层级。请查看整个组织的支出,而不要仅依据单个项目的支出。

查看多个组织的数据

用量仪表板不会合并不同组织的费用或用量数据。每个组织(包括子组织)均单独统计。

要查看子组织,请在组织选择器中选择该子组织。

如果需要合并报告,可考虑使用同一组织内的项目来代替独立的子组织,或使用 Usage API 进行自定义分析。

检查 API 响应中的 Token 用量

Token 用量字段的名称因端点而异。

Token 数Chat CompletionsResponses
输入 Tokenusage.prompt_tokensusage.input_tokens
输出 Tokenusage.completion_tokensusage.output_tokens
Token 总数usage.total_tokensusage.total_tokens

Chat Completions 的响应可以包含 Token 用量信息。示例如下:

{
"usage": {
"prompt_tokens": 13,
"completion_tokens": 7,
"total_tokens": 20
}
}

根据所用端点和模型的不同,用量明细还可能包含缓存输入和推理 Token 的数量。这些数据有助于解释为什么回复的可见长度无法反映其全部 Token 用量。

有关不同 Token 类别的说明,请参阅:了解和计算 Token。

如果转写响应中包含 Token 用量,音频和文本输入 Token 就已经计入 input_tokens。请勿将这些数量再次加到输入总量中。请单独比较 output_tokens。

获取流式 Chat Completions 的用量

在流式 Chat Completions 请求中,添加以下配置:

{
"stream": true,
"stream_options": {
"include_usage": true
}
}

启用 include_usage 后,data: [DONE] 之前会有一个额外的数据块,其中包含整个请求的用量。该数据块的 choices 数组为空。其他数据块的 usage 值为 null。

如果流式传输中断,你可能无法收到最后这个用量数据块。未收到最后的数据块,并不能证明该请求没有消耗 Token。

此配置仅适用于 Chat Completions。详情请参阅:Chat Completions API 参考文档。

这篇文章对你有帮助吗?