获取个人用量数据
GET /api/data/self
按时间范围获取当前用户的用量统计数据,通常用于绘制消耗趋势图。时间跨度不能超过 1 个月(2592000 秒)。
鉴权说明
用户控制台接口,需登录用户身份(会话 Cookie,或 Authorization: Bearer <access_token>)。此令牌与模型调用使用的 sk- 密钥不同。
Query 参数
| 参数名 | 类型 | 必选 | 说明 |
|---|---|---|---|
start_timestamp | integer | 可选 | 起始时间(Unix 时间戳,秒) |
end_timestamp | integer | 可选 | 结束时间(Unix 时间戳,秒) |
时间跨度限制
end_timestamp - start_timestamp 不能超过 2592000 秒(约 1 个月),否则返回 {"success": false, "message": "时间跨度不能超过 1 个月"}。
响应字段(200)
| 字段名 | 类型 | 说明 |
|---|---|---|
success | boolean | 是否成功 |
message | string | 提示信息 |
data | array<object> | 用量数据列表,元素结构见下方 ↳ 用量数据对象 |
用量数据对象字段
| 字段名 | 类型 | 说明 |
|---|---|---|
id | integer | 记录 ID |
user_id | integer | 用户 ID |
username | string | 用户名 |
model_name | string | 模型名称 |
created_at | integer | 统计时间(Unix 时间戳,秒) |
token_used | integer | Token 用量 |
count | integer | 请求次数 |
quota | integer | 消耗额度 |