查询个人账户用量

接口路径

GET /api/open/data/self

配额计算说明

quota 为内部额度单位，换算成金额（人民币）的方式：

金额(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中：

• quota：来自本接口返回的 data[].quota
• quota_per_unit、usd_exchange_rate、quota_display_type：来自 查询换算参数 接口（GET /api/open/status）

若 quota_display_type = USD（美元），则去掉 × usd_exchange_rate。

请求参数

字段	类型	是否必传	说明	限制条件	备注
start_timestamp	int64	否	开始时间戳（秒）	与 end_timestamp 配合使用	示例: 1711468800
end_timestamp	int64	否	结束时间戳（秒）	与 start_timestamp 配合使用	示例: 1712073600

时间范围规则

情景	处理方式
不传时间参数	使用默认最近 7 天
只传 start_timestamp	将 end_timestamp 补齐为当前时间
只传 end_timestamp	将 start_timestamp 补齐为当前时间 7 天前
时间跨度超过 31 天	返回错误「时间跨度不能超过 31 天」

请求示例

GET 'https://neolink.com/backend/api/open/data/self?start_timestamp=1711468800&end_timestamp=1712073600'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	-
message	string	是	错误提示（成功时为空）	已按 X-Accept-Language 翻译
data	[]QuotaDataItem	是	配额统计数据数组	按时间 + 模型聚合；详见下表

QuotaDataItem 对象（data 数组元素）

字段	类型	是否必传	说明	备注
id	int	是	配额数据记录 ID	-
user_id	int	是	用户 ID	-
username	string	是	用户名	-
model_name	string	是	模型代码	已转换为模型代码（非原始模型名）
created_at	int64	是	统计时间戳（秒）	精确到小时；Unix 时间戳
token_used	int	是	该时段该模型消耗的 token 数	-
count	int	是	该时段该模型的调用次数	-
quota	int	是	该时段该模型消耗的配额值	内部额度单位；换算见上文「配额计算说明」
token_id	int	是	所属 Token ID	0 = 未关联（如直接用户账号）

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": [
    {
      "id": 1,
      "user_id": 100,
      "username": "john_doe",
      "model_name": "gpt-4",
      "created_at": 1711497600,
      "token_used": 12500,
      "quota": 62500,
      "count": 25,
      "token_id": 0
    },
    {
      "id": 2,
      "user_id": 100,
      "username": "john_doe",
      "model_name": "gpt-3.5-turbo",
      "created_at": 1711497600,
      "token_used": 50000,
      "quota": 25000,
      "count": 100,
      "token_id": 0
    }
  ]
}
错误响应
{
  "success": false,
  "message": "时间跨度不能超过 31 天"
}