查询个人调用日志

返回当前登录用户个人模式（enterprise_id=0）下的消费日志。

接口路径

GET /api/open/log/self

限流说明

本接口使用独立限流策略 OpenLogRateLimit：每用户每分钟最多 5 次，独立于其它 Open 限流。

花费计算说明

最终花费（人民币）计算方式：

最终花费(¥) = quota ÷ quota_per_unit × usd_exchange_rate

其中：

• quota：来自本接口返回的 data.items[].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 的差值不能超过 1 个自然月	示例: 1711468800
end_timestamp	int64	否	结束时间戳（秒）	与 start_timestamp 的差值不能超过 1 个自然月	示例: 1711555200
token_name	string	否	Token 名称过滤	精确匹配	示例: ximi令牌2
model_name	string	否	模型名称过滤	模糊匹配	示例: gpt-4o
billing_source	string	否	按扣费来源过滤消费日志	支持单个值或逗号分隔多值；空或不传、或 -1 = 不过滤（返回全部来源，含权益类）	见下文取值枚举
p	int	否	页码	默认 1	示例: 1
page_size	int	否	每页数量	默认 10；最大 500	示例: 20

billing_source 取值枚举

值	含义	典型场景
0	余额按量扣费	普通 API Key 现金/余额调用
1	订阅席位权益	订阅包席位调用
2	权益包 / 资源包	资源包调用
3	免费	免费额度调用

时间范围规则

情景	处理方式
start_timestamp 与 end_timestamp 均未传	默认 start = now - 86400，end = now（最近 24 小时）
只传其一	不套用默认 24 小时规则
开始时间与结束时间差值超过 1 个自然月	请求失败

请求示例

GET 'https://neolink.com/backend/api/open/log/self?p=1&page_size=20'

返回信息

字段	类型	是否必传	说明	备注
success	bool	是	请求是否成功	固定值
message	string	是	错误提示信息（成功时为空）	固定值
data	PageInfo	是	分页数据对象	详见下表

PageInfo 对象

字段	类型	是否必传	说明	备注
page	int	是	当前页码
page_size	int	是	每页条数
total	int	是	总条数
items	[]LogItem	是	日志列表	详见下表

LogItem 对象

字段	类型	是否必传	说明	备注
request_id	string	是	请求 ID
created_at	int64	是	创建时间	Unix 秒级时间戳
token_name	string	是	Token / API Key 名称
model_name	string	是	模型名称
quota	int	是	消耗配额	花费计算见上文「花费计算说明」
prompt_tokens	int	是	输入 Token 数
completion_tokens	int	是	输出 Token 数
cache_tokens	int64	是	缓存命中 Token 数
cache_creation_tokens	int64	是	缓存创建 Token 数
use_time	int	是	请求耗时（秒）
is_stream	bool	是	是否流式	true=流式；false=非流式

返回示例

成功响应
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "request_id": "req_abc123",
        "created_at": 1747818790,
        "token_name": "ximi令牌2",
        "model_name": "gemini-1.5-pro",
        "quota": 442680,
        "prompt_tokens": 166833,
        "completion_tokens": 226,
        "cache_tokens": 0,
        "cache_creation_tokens": 0,
        "use_time": 1,
        "is_stream": false
      }
    ]
  }
}
空列表
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 0,
    "items": []
  }
}
错误响应
{
  "success": false,
  "message": "无权进行此操作，未登录且未提供 access token"
}