Skip to Content
用户与 API Key用量与明细

用量与明细

本页接口使用个人令牌鉴权。请求头格式和令牌创建方式见个人令牌。

日志查询接口的请求频率限制为 60 QPM。超出限制时返回 HTTP 429,请按照 Retry-After 响应头等待后重试,并避免并发刷新用量汇总和明细。

查询用户用量汇总

接口GET /api/log/self/stat

只需要指定时间段的消费合计时,使用汇总接口:

curl "https://api.example.com/api/log/self/stat?start_timestamp=1786377600&end_timestamp=1786463999&token_name=production" \ -H "Authorization: Bearer <PERSONAL_ACCESS_TOKEN>"

请求参数

参数必填说明
start_timestamp是开始时间,Unix 秒级时间戳。例如 1786377600 表示 2026-08-11 00:00:00 UTC+8。与 end_timestamp 的间隔必须小于 31 天
end_timestamp是结束时间,Unix 秒级时间戳。例如 1786463999 表示 2026-08-11 23:59:59 UTC+8。与 start_timestamp 的间隔必须小于 31 天
model_name否按模型名称筛选
token_name否按 API Key 名称精确筛选,可从 Key 管理 获取
{ "success": true, "message": "", "data": { "quota": 500000, "rpm": 2, "tpm": 3200 } }

响应字段

字段含义
data.quota指定筛选范围内的消费额度,除以 500000 换算为美元
data.rpm最近 60 秒内符合筛选条件的请求数,不是整个查询时间段的累计值
data.tpm最近 60 秒内符合筛选条件的输入与输出 Token 总数,不是整个查询时间段的累计值

查询用户用量明细

接口GET /api/log/self
curl "https://api.example.com/api/log/self?page_size=100&type=2&start_timestamp=1786377600&end_timestamp=1786463999&token_name=production" \ -H "Authorization: Bearer <PERSONAL_ACCESS_TOKEN>"

请求参数

参数必填说明
page_size否单次返回条数,默认 10,最大 100
cursor否上一批响应中的 next_cursor,首次请求不传;该值为不透明游标,请原样传递
type否2 表示消费记录;0 表示全部日志类型
start_timestamp否开始时间,Unix 秒级时间戳。例如 1786377600 表示 2026-08-11 00:00:00 UTC+8
end_timestamp否结束时间,Unix 秒级时间戳。例如 1786463999 表示 2026-08-11 23:59:59 UTC+8
model_name否按模型名称筛选
token_name否按 API Key 名称精确筛选,可从 Key 管理 获取
request_id否按请求 ID 精确查询

响应按创建时间倒序返回。首次请求不传 cursor;当 has_more 为 true 时,将 next_cursor 原样作为下一批请求的 cursor。接口不返回符合条件的日志总数:

{ "success": true, "message": "", "data": { "page_size": 100, "has_more": true, "next_cursor": "eyJjcmVhdGVkX2F0IjoxNzg2NDU2NzM2LCJpZCI6MTIzNDU2fQ", "items": [ { "created_at": 1786456736, "type": 2, "model_name": "deepseek-v4-pro", "token_name": "production", "quota": 2500, "prompt_tokens": 1200, "completion_tokens": 360, "request_id": "req_xxxxxxxxxxxxxxxx" } ] } }

响应字段

字段说明
data.items本次返回的用量明细,按创建时间倒序排列
data.page_size本次请求的返回条数上限
data.has_more是否还有更多记录
data.next_cursor后续查询游标;没有更多记录时为空字符串

查询下一批

curl "https://api.example.com/api/log/self?page_size=100&type=2&start_timestamp=1786377600&end_timestamp=1786463999&cursor=eyJjcmVhdGVkX2F0IjoxNzg2NDU2NzM2LCJpZCI6MTIzNDU2fQ" \ -H "Authorization: Bearer <PERSONAL_ACCESS_TOKEN>"

客户端应同时检查 HTTP 状态码和响应中的 success。没有时间范围时会查询全部可用日志,生产调用建议始终限定时间范围。避免高频轮询;需要持续展示用量时,请根据业务场景设置合理的缓存和刷新间隔。

Last updated on