请输入
菜单

日志与统计

本章节接口用于查询你的调用记录和消耗情况。

规范:

•时间戳为秒级 Unix 时间戳。传 0 或不传表示不过滤该端点。
•额度单位:默认 1 美元 = 500,000 quota。
•日志类型 type 用于日志查询接口的 type 参数:
值 含义 说明
0 全部 不过滤类型,默认值
1 充值 账户充值事件
2 消费 API 调用扣费
3 管理 系统调整
4 系统 系统事件
5 错误 调用失败
6 退款 部分场景自动退款

1. 查看个人使用日志

分页查询你的调用明细,支持按时间段、令牌、模型等条件过滤。

请求

•方法:GET
•路径:/api/log/self

Query 参数(全部可选):

参数 类型 默认 说明
p int 1 页码
page_size int 20 每页条数,上限 100
type int 0 日志类型;0 表示全部
start_timestamp int 0 起始时间戳(秒);0 表示不限
end_timestamp int 0 结束时间戳(秒);0 表示不限
token_name string — 按令牌名称精确过滤
model_name string — 按模型名过滤
group string — 按分组过滤
request_id string — 按请求 ID 精确匹配(用于排障)

响应

upstream_request_id 使用 omitempty:上游未返回请求 ID 时,该字段不会出现在 JSON 中;有值时才会返回。
{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 528,
    "items": [
      {
        "id": 8890,
        "user_id": 12345,
        "created_at": 1783656777,
        "type": 2,
        "content": "",
        "username": "example_user",
        "token_name": "my-key",
        "model_name": "claude-sonnet-4-6",
        "quota": 169893,
        "prompt_tokens": 3734,
        "completion_tokens": 0,
        "use_time": 12,
        "is_stream": false,
        "channel": 12,
        "channel_name": "",
        "token_id": 1001,
        "group": "default",
        "ip": "203.0.113.42",
        "request_id": "202607290628491263137328268d9d6P1Td6Ml2",
        "other": "{
	"cache_creation_tokens": 2010,
	"cache_tokens": 63742,
	"cache_write_tokens": 2010
}"
      }
    ]
  }
}

日志条目字段:

字段 类型 说明
id int 日志 ID
user_id int 用户 ID
created_at int 记录时间(秒级 Unix 时间戳)
type int 日志类型(见 README)
content string 事件描述;对消费类日志通常为空
username string 用户名
token_name string 触发调用的令牌名
model_name string 调用的模型名
quota int 本次消耗额度(quota 单位);折算美元 = quota / 500000(默认比例,具体见控制台)
prompt_tokens int 输入 token 数
completion_tokens int 输出 token 数
use_time int 请求耗时(秒)
is_stream boolean 是否为流式响应
channel int 上游渠道 ID
channel_name string 上游渠道名
token_id int 令牌 ID
group string 生效的分组
ip string 请求来源 IP
request_id string 本次请求的唯一 ID,可用于排障
upstream_request_id string 上游供应商返回的请求 ID(如有)
other string

附加信息(JSON 字符串或空),常见于消费类日志,包含计费明细、流式状态等,需自行二次解析

cache_creation_tokens,缓存创建token数

cache_write_tokens,缓存写入token数

cache_tokens,缓存读取token数

示例

查询最近一周的所有消费记录:

END=$(date +%s)
START=$((END - 7*86400))

curl -sS "https://ailink.nativex.com/api/log/self?type=2&start_timestamp=$START&end_timestamp=$END&p=1&page_size=50" \
  -H "Authorization: Bearer <你的系统访问令牌>"

查询某个令牌的所有调用:

curl -sS "https://ailink.nativex.com/api/log/self?token_name=my-key&p=1&page_size=50" \
  -H "Authorization: Bearer <你的系统访问令牌>"

根据 request_id 定位单次调用(排障常用):

•不传 start_timestamp 和 end_timestamp 会返回所有历史日志(分页限制下)。
•建议做长期消耗分析时分页拉全,然后在客户端聚合(按模型、按令牌等)。
•单次分页 page_size 上限 100,超出的请求会被截断。
curl -sS "https://ailink.nativex.com/api/log/self?request_id=xxxxxxxx-xxxx-xxxx" \
  -H "Authorization: Bearer <你的系统访问令牌>"

说明


2. 个人日志统计

对指定条件下的日志做聚合统计,返回消耗总额、当前 RPM/TPM。

请求

•方法:GET
•路径:/api/log/self/stat

Query 参数(全部可选):

参数 类型 默认 说明
type int 0 日志类型
start_timestamp int 0 起始时间戳(秒)
end_timestamp int 0 结束时间戳(秒)
token_name string — 按令牌名过滤
model_name string — 按模型名过滤
channel int 0 按渠道 ID 过滤
group string — 按分组过滤

响应

{
  "success": true,
  "message": "",
  "data": {
    "quota": 6535469,
    "rpm": 0,
    "tpm": 0
  }
}

字段说明:

字段 类型 说明
quota int 时间段内累计消耗(quota 单位);折算美元 = quota / 500000(默认比例,具体见控制台)
rpm int 当前请求速率(每分钟请求数),实时近似值
tpm int 当前 token 速率(每分钟 token 数),实时近似值

示例

查全时段总消耗:

curl -sS "https://ailink.nativex.com/api/log/self/stat?type=0" \
  -H "Authorization: Bearer <你的系统访问令牌>"

查最近 30 天某个模型的消耗:

END=$(date +%s)
START=$((END - 30*86400))

curl -sS "https://ailink.nativex.com/api/log/self/stat?type=2&start_timestamp=$START&end_timestamp=$END&model_name=claude-sonnet-4-6" \
  -H "Authorization: Bearer <你的系统访问令牌>"

查某个令牌的消耗:

curl -sS "https://ailink.nativex.com/api/log/self/stat?token_name=my-key" \
  -H "Authorization: Bearer <你的系统访问令牌>"

说明

•该接口只返回聚合数值,如需按模型/按令牌分组的明细报表,请分页拉「使用日志」接口后在客户端做聚合。
•rpm / tpm 是最近一段时间的实时估算,长时间无调用时都会为 0,不代表全时段的平均值。
•时间跨度较大时接口耗时会显著增加,建议合理设置时间窗口。
最近修改: 2026-11-06