GET
/
prod-api
/
api
/
logs
/
v2
/
page
日志查询
curl --request GET \
  --url https://maas.novawander.cn/prod-api/api/logs/v2/page
分页查询当前凭证所属范围内的调用、消费、充值、管理、错误、退款和测试金日志。

接口信息

  • HTTP 方法:GET
  • 请求地址:https://maas.novawander.cn/prod-api/api/logs/v2/page
  • 鉴权请求头:Authorization
  • 语言请求头:Accept-Language,支持 zh-CN、en-US
  • 时间格式:yyyy-MM-dd HH:mm:ss
  • 时间范围上限:31 天
  • 默认分页:page=1、pageSize=30
  • 每页数量上限:1000

用户鉴权

以下格式均支持:
Authorization: Bearer sk-your_api_key
Authorization: sk-your_api_key
凭证查询范围tokenName 行为
系统访问令牌该用户的日志使用请求传入的 tokenName,按模糊匹配
API Key该用户且属于当前 API Key 的日志服务端强制精确匹配当前 API Key 名称,忽略请求传入的 tokenName
不要在 URL、前端代码、日志或工单中明文记录完整 Key。

查询参数

page
integer
默认值:"1"
页码;小于或等于 0 时按 1 处理
pageSize
integer
默认值:"30"
每页数量;小于或等于 0 时按 30 处理,最大 1000
tokenName
string
APIkey名称, 鉴权方式为系统访问令牌时模糊查询; 为APIkey时不可用,强制查询当前APIkey的日志
modelName
string
模型名称,精确匹配;多个模型用英文逗号分隔
requestId
string
请求 ID,精确匹配
ip
string
请求 IP,精确匹配
useTimeMin
integer
最小用时,单位秒,包含边界
useTimeMax
integer
最大用时,单位秒,包含边界
startTime
string
开始时间,格式 yyyy-MM-dd HH:mm:ss,包含边界
endTime
string
结束时间,格式 yyyy-MM-dd HH:mm:ss,包含边界
types
string
日志类型,多个值用英文逗号分隔;允许值为 1,2,3,5,6,8

日志类型

值类型
1充值
2消费
3管理
5错误
6退款
8测试金

Accept-Language

只影响 billingProcessText:
请求头返回语言
Accept-Language: zh-CN中文
Accept-Language: en-US英文
未传或其他值中文

请求示例

curl --get 'https://maas.novawander.cn/prod-api/api/logs/v2/page' \
  --header 'Authorization: Bearer your_api_key' \
  --header 'Accept-Language: zh-CN' \
  --data-urlencode 'page=1' \
  --data-urlencode 'pageSize=30' \
  --data-urlencode 'startTime=2026-07-01 00:00:00' \
  --data-urlencode 'endTime=2026-07-21 23:59:59' \
  --data-urlencode 'types=2,5'

响应结构

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "total": 1,
    "rows": [
      {
        "id": "7485162150730129409",
        "createdAt": 1784601721,
        "createTime": "2026-07-21 10:42:01",
        "type": 2,
        "requestId": "request_example_001",
        "ip": "203.0.113.10",
        "requestPath": "/v1/messages",
        "isStream": 1,
        "streamStatus": "正常 (eof)",
        "useTime": 2,
        "firstTokenTime": 1043,
        "modelName": "claude-sonnet-5",
        "tokenName": "default",
        "quotaDollar": "0.006098",
        "billingType": "token_ratio",
        "billingCountMode": "上游返回",
        "requestConversion": "Claude Messages",
        "textInputTokens": 2804,
        "textOutputTokens": 49,
        "cacheCreationTokens5m": null,
        "cacheCreationTokens1h": null,
        "cacheTokens": 0,
        "audioInput": null,
        "audioOutput": null,
        "imageInputTokens": null,
        "imageOutputTokens": null,
        "videoOutputTokens": null,
        "requestedSeconds": null,
        "imageCount": null,
        "videoResolution": null,
        "videoAudio": null,
        "videoHasInputVideo": null,
        "toolCallBilling": null,
        "billingProcessText": "输入价格:...,最终费用:$0.006098"
      }
    ]
  }
}
金额字段 quotaDollar 使用十进制字符串返回,调用方应使用 Decimal/BigDecimal 处理,不建议转换为二进制浮点数。

响应字段

字段类型说明
codeinteger200 表示成功,401 表示鉴权失败
msgstring响应说明
data.totalinteger符合条件的总记录数,不是总页数
data.rowsarray当前页数据
idstring/long日志 ID,客户端建议按字符串处理
createdAtintegerUnix 秒级时间戳
createTimestring格式化创建时间
typeinteger日志类型
requestIdstring/null请求 ID
ipstring/null请求 IP
requestPathstring/null请求路径
isStreaminteger/null是否流式
streamStatusstring/null流式状态
useTimeinteger/null总用时,单位秒
firstTokenTimeinteger/null首字时间,单位毫秒
modelNamestring/null模型名称
tokenNamestring/nullToken 名称
quotaDollardecimal/null客户花费,单位美元
billingTypestring/null计费类型
billingCountModestring/null计费统计方式
requestConversionstring/null请求协议转换类型
textInputTokensinteger/null文本输入 Token
textOutputTokensinteger/null文本输出 Token
cacheCreationTokens5minteger/null5分钟缓存创建 Token
cacheCreationTokens1hinteger/null1小时缓存创建 Token
cacheTokensinteger/null缓存命中 Token
audioInputinteger/null音频输入计量
audioOutputinteger/null音频输出计量
imageInputTokensinteger/null图片输入 Token
imageOutputTokensinteger/null图片输出 Token
videoOutputTokensinteger/null视频输出 Token
requestedSecondsinteger/null请求时长,单位秒
imageCountinteger/null图片数量
videoResolutionstring/null视频分辨率
videoAudioboolean/null是否输出音频
videoHasInputVideoboolean/null是否包含输入视频
toolCallBillingarray/null工具调用计费明细
billingProcessTextstring/null按 Accept-Language 返回的计费过程

失败响应

{
  "code": 401,
  "msg": "Authorization header missing or invalid",
  "data": null
}

调用建议

  1. 服务端安全保存访问令牌或 API Key,不要把完整 Key 写入日志。
  2. 推荐传入不超过 31 天的时间范围。
  3. 翻页时读取 data.total,但不要把它当作页数。
  4. 检查响应体 code,不要只依据 HTTP 200 判断业务成功。
  5. 金额使用 Decimal/BigDecimal 处理,不要用二进制浮点数重新计算。