接口 / Usage
请求详情
GET
/api/usage/requests/{request_id}查询一次已完成请求的对账记录。OpenAI-compatible 响应里的 usage 不一定包含完整 cache write、provider raw usage、计费明细和 routing metadata,完整信息看这个接口。
路径参数
request_idstringrequired
同一个 API key 发起的请求 ID。Lazu 不允许读取其它 key 的请求详情。
响应字段
request_idstring请求 ID。
modelstring用户请求的模型或 route 名称。
resolved_modelstringnullable
实际上游模型。
usage.dimensionsobject[]标准化 usage 维度,例如 input、output、
cache_read、cache_write_5m、
cache_write_1h、cache_miss、audio/image 维度等。
billing.line_itemsobject[]计费明细。
provider_usage.raw_fieldsobject用于对账的 provider 原始 usage 字段。
routingobjectnullable
请求经过 routing 时返回路由元数据。
Cache 字段
OpenAI-compatible 响应里,cache read 可能出现在
usage.prompt_tokens_details.cached_tokens 或
usage.input_tokens_details.cached_tokens。
cache write 只有在上游返回时才会出现,字段可能是
cache_write_tokens、cache_write_5m_tokens 或
cache_write_1h_tokens。
如果要对账或排查费用,以请求详情 API 为准。