跳转到主要内容
GET
查询请求花费
本接口用于查询同步接口调用的花费,主要适用于文本模型,例如 Chat Completions、Messages、Responses 等接口。Request ID 取原请求响应头 X-Request-Id 的值。请求完成后稍等片刻即可查询;异步任务请使用 查询任务状态。

授权

Authorization
string
header
必填

##所有接口均需要使用Bearer Token进行认证##

获取 API Key :

访问 API Key 管理页面 获取您的 API Key

使用时在请求头中添加:

路径参数

request_id
string
必填

Request ID,取原请求响应头 X-Request-Id 的值。查询时请忽略 {},直接拼接在路径末尾。

Maximum string length: 64

响应

查询成功

id
string
必填

Request ID

示例:

"20261117223155519063884QnAx70lK"

object
enum<string>
必填

对象类型,固定为 request

可用选项:
request
示例:

"request"

model
string
必填

请求使用的模型

示例:

"claude-haiku-5-5"

status
enum<string>
必填

请求状态:

  • completed:请求成功完成。
  • failed:请求失败。失败前已产生用量的(例如流式输出中途中断),usage 中如实返回已扣除的费用。
  • blocked:请求在处理前被拒绝,例如账户余额不足、API Key 额度已用完、已禁用、已过期或不允许使用该模型,不产生费用。
可用选项:
completed,
failed,
blocked
示例:

"completed"

finished_at
integer
必填

请求结束时间(Unix 时间戳,秒)

示例:

1794925917

usage
object
必填

用量与费用。始终返回;未产生费用时各项为 0。

error
object

失败原因,仅当 status 为 failed 或 blocked 时返回。只包含说明文字,不含错误码;需要按错误码处理时,请以原请求返回的错误为准。