查询请求用量
/v1/billing/requests/{request_id}按单次推理调用查询 账单与计量摘要。
认证
Authorization Bearer
在 Authorization 请求头中使用 API Key（sk-…）。
使用原始响应头中的 X-Trace-ID。若与 X-Request-ID 不同，优先使用 X-Trace-ID。异步 Chat 使用 job 对象的 request_id。
路径参数
request_idstringrequired原始响应中的完整请求 ID，或异步 Chat job 的 request_id。 ID 包含 `/` 时保留斜杠作为路径分隔符；各段中的其他保留字符仅进行一次 URL 编码。
查询参数
typeenum<string>可选筛选参数。可选值：all（全部类型，默认值）、llm（LLM 调用，包括异步 Chat 和 LLM 批量任务行）、image（图像生成）、audio（音频生成）、video（视频生成）。不传或传 all 时查询全部类型。类型不匹配时无结果。此参数不能消除 ID 歧义。
响应
codeinteger响应状态码。
msgstring响应消息。
dataobject | nulldata.idstring本次账单查询结果返回的标识符，请将其视为不透明字符串。
data.request_idstring返回的对账请求标识符，可能与查询时使用的响应或任务 ID 不同。
data.typestring如 llm、image、audio、video。
data.modelstring展示用模型名。
data.model_namestring | null模型名（若有）。
data.statusstring任务或请求状态（若有）。
data.create_timeinteger | string | null创建时间 epoch 秒（UTC）；JSON 可能为字符串或数字。
data.update_timeinteger | string | null最后更新时间 epoch 秒（UTC）；JSON 可能为字符串或数字。
data.billedboolean | null用量是否已扣费。
data.total_amountnumber | null已结算总金额（若有）。
data.wallet_amountnumber | null钱包扣减部分（若有）。
data.voucher_amountnumber | null代金券部分（若有）。
data.bill_record_statusstring | null计费状态（若有）。
data.status_codestring | null请求状态码字符串（若有）。
data.pricenumber | null适用的目录价格（若有）。
data.billing_atinteger | string | null计费时间戳 epoch 秒（若有）；JSON 可能为字符串或数字。
data.amount_basenumber | null折扣前金额（若有）。
data.amount_finalnumber | null折扣后金额（若有）。
data.currencystring | null上述计费金额的币种（若有）。
data.usageobject | null用量详情，例如 token 数量或时长。具体字段因模型和接口而异。
data.durationnumber | null生成耗时（秒，若已知）。
trace_idstring | null用于诊断的请求标识符，可能为空。
service_codestring | null稳定业务错误码，可能为空。
错误处理
未认证时请检查 API Key。未找到时响应体为 code: 404、data: null；账单详情尚未就绪时可稍后重试。AMBIGUOUS_REQUEST_ID 表示 ID 匹配多个请求，请使用原始调用的 X-Trace-ID，异步 Chat 使用 job 的 request_id。