用量与明细
本页接口使用个人令牌鉴权。请求头格式和令牌创建方式见个人令牌。
日志查询接口的请求频率限制为 60 QPM。超出限制时返回 HTTP 429,请按照 Retry-After 响应头等待后重试,并避免并发刷新用量汇总和明细。
查询用户用量汇总
只需要指定时间段的消费合计时,使用汇总接口:
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 总数,不是整个查询时间段的累计值 |
查询用户用量明细
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