查询请求用量
/v1/billing/{request_id}按单次推理调用响应头中的 X-Trace-ID 查询 账单与计量摘要。如果 X-Trace-ID 与 X-Request-ID 不同，本接口使用 X-Trace-ID。
认证
Authorization Bearer
在 Authorization 请求头中使用 API Key（sk-…）。
路径参数
request_idstringrequired计费关联 id：取该次推理调用 HTTP 响应头中的 X-Trace-ID。如果 X-Trace-ID 与 X-Request-ID 不同，请使用 X-Trace-ID。
查询参数
typestring可选。不传等同于 all（全类型解析）。仅在仅靠 request id 可能歧义、需要收窄为 llm / image / audio / video 时再传。
响应
响应体为通用 R<T>（code、msg、data、trace_id；部分错误含 service_code）。成功时 code 为 200，data 为 计费对账摘要；失败时 data 为 null。
codeinteger响应状态码。
msgstring响应消息。
dataobject | nulldata.idstring行主键 id。
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用量行上记录的 HTTP/状态码字符串（若有）。
data.pricenumber | null用量行上的厂商价目快照（若有）。
data.billing_atinteger | string | null计费时间戳 epoch 秒（若有）；JSON 可能为字符串或数字。
data.amount_basenumber | null折扣前金额（计费管线，若有）。
data.amount_finalnumber | null钱包拆分前的最终计费金额（若有）。
data.currencystring | null上述计费金额的币种（若有）。
data.usageobject | null合并后的计量字段：tokens、嵌套 usage、时长档位等（不含大块 explain/trace）。
data.durationnumber | null生成耗时（秒，若已知）。
trace_idstring | null服务端 trace，可能为空。
service_codestring | null稳定业务错误码，可能为空。
错误处理
- 未鉴权 / 凭证无效：与其它受保护接口一致。
- 404：
request_id不存在或无权访问。注意，短时间 404 也可能表示账本尚未写入，因为入账可能略晚于模型响应。
Request ID（计费关联说明）
- 使用推理响应头中的
X-Trace-ID作为本接口的request_id。 - 如果
X-Trace-ID与X-Request-ID不同，请使用X-Trace-ID。 - 可在请求上自带
X-Request-ID/X-Trace-ID作为幂等或对账键；不传则由服务端生成 UUID。 - 不要使用 Chat JSON 里的
id（chatcmpl-…）或 Video 资源的id（video_…）。视频请保存POST /v1/videos当次响应头；每次GET轮询都会换新的 trace。 - 视频任务在终态后，
GET /v1/videos/{video_id}（或等价轮询接口）返回的资源体上可能出现usage字段，可作除本接口外的纯计量参考。