本章节接口用于查询你的调用记录和消耗情况。
规范:
•时间戳为秒级 Unix 时间戳。传
0 或不传表示不过滤该端点。•额度单位:默认
1 美元 = 500,000 quota。•日志类型
type 用于日志查询接口的 type 参数:| 值 | 含义 | 说明 |
|---|---|---|
| 0 | 全部 | 不过滤类型,默认值 |
| 1 | 充值 | 账户充值事件 |
| 2 | 消费 | API 调用扣费 |
| 3 | 管理 | 系统调整 |
| 4 | 系统 | 系统事件 |
| 5 | 错误 | 调用失败 |
| 6 | 退款 | 部分场景自动退款 |
1. 查看个人使用日志
分页查询你的调用明细,支持按时间段、令牌、模型等条件过滤。
请求
•方法:
GET•路径:
/api/log/selfQuery 参数(全部可选):
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
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/statQuery 参数(全部可选):
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
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,不代表全时段的平均值。•时间跨度较大时接口耗时会显著增加,建议合理设置时间窗口。