Skip to main content
GET
查询请求明细
本接口要求 Admin Key 具备 billing:read 作用域。
用 X-Msh-Client-Request-Id 精确对行:调用推理 API 时在请求头带上你自己系统的请求 ID(X-Msh-Client-Request-Id: <你的请求ID>),我方计费明细会把该值落表记录为 client_request_id。对账时拉取本 feed,用你的 request_id 与记录里的 client_request_id 精确对行——这笔有没有记、记成什么样(tokens 量、是否闲时命中),逐笔可核,无需按「时间 + tokens」推断。断连核实请改用中断请求专用 feed(interrupted_requests);金额核对以日账单/产品账单为准(本 feed 只给 token 量、不含金额),用 client_request_id 可在两类接口间精确关联。例:「我们网关 request_id=abc123 的这笔请求被扣费了,为什么?」→ 用该 ID 在 request_details 里查 client_request_id=abc123 的记录确认 token 量,再到日账单核对当日金额。

授权

Authorization
string
header
必填

Authorization 请求头携带 Admin API secret 作为 Bearer 令牌,格式为 Bearer sk-admin-***。Admin Key 可在「控制台 → 组织管理 → Admin API Keys」创建。

查询参数

start
integer<int64>
必填

起始时间(epoch 毫秒),含边界。例如 1790784000000(2026-10-01 00:00 CST)。

必填范围: x >= 0
end
integer<int64>
必填

结束时间(epoch 毫秒),不含边界。例如 1792598400000(2026-10-22 00:00 CST)。

必填范围: x >= 0
project_id
string[]

项目 ID 列表。每个项目都必须属于当前认证组织。

key
string[]

推理 API 密钥 ID 列表。每个 key 都必须属于当前认证组织。

desc
boolean

是否按服务端写入时间降序排列。排序键是写入时间,而非 time 字段,因此同一秒内的行不保证按请求时间单调。默认 true(降序)。

limit
integer
默认值:100

页大小。交互式查询默认 100;批量拉取可调大(最高 10000)—— 大批量拉取可能增加单页延迟(非 SLA 承诺)。

必填范围: 1 <= x <= 10000
cursor
string

上一次响应 next 字段返回的游标。游标只携带页位置;每次翻页都需原样重复全部查询参数(limit 除外),服务端不校验参数一致性。

响应

请求明细。

data
object[]
必填

请求明细行(每个请求一行)。

has_more
boolean
必填

是否还有下一页。

next
string | null
必填

下一页游标。翻页时将其原样作为 cursor 参数传回。