AI 大模型推理 > API 文档 > 请求日志下载

请求日志下载

最近更新时间: 2026-03-26 11:50:08

Base URL: `https://api.qnaigc.com`

概述

本接口用于导出请求日志，是 log 接口的导出版本。如需导出文件请将路径中的 export_log 改为 export_log_file，其余不变。

认证方式

支持两种鉴权方式：

AK/SK 签名认证：使用七牛云标准的 AK/SK 签名认证
```
Authorization: Qiniu <AccessKey>:<EncodedSign>
```
APIKey 认证：使用 APIKey 进行认证
```
Authorization: Bearer <APIKey>
```

接口详情

GET `/v2/stat/export_log`

请求头：

名称	类型	必填	描述
`Authorization`	`string`	否	支持 AK/SK 和 APIKey 两种鉴权方式。格式为 `Qiniu <AccessKey>:<EncodedSign>` 或 `Bearer <APIKey>`

查询参数：

参数	类型	必填	说明
`start`	`string`	是	开始时间，格式为 `2006-01-02T15:04:05Z07:00`。默认按照请求时间倒排，不支持排序设置。左闭右开，精确比较。开始和结束最多相差七天。
`end`	`string`	是	结束时间，格式为 `2006-01-02T15:04:05Z07:00`。默认按照请求时间倒排，不支持排序设置。开始和结束最多相差 35 天。
`size`	`integer`	是	返回数据条数，应为 1~500。默认值：100
`model`	`string`	否	模型名称，用于过滤特定模型的请求日志。示例：`deepseek/deepseek-v3.1`
`code`	`string`	否	HTTP 状态码，用于过滤特定状态码的请求日志。示例：`200`
`page`	`integer`	否	页码，用于超出 500 条数据的分批导出。比如请求前 1500 条，应分别发送 `page=1`、`page=2`、`page=3` 且其余参数不变的请求。默认值：1
`apikey`	`string`	否	APIKey 值，用于过滤特定 APIKey 的请求日志。示例：`sk-xx`

请求示例：

curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2006-01-02T15:04:05Z07:00&end=2006-01-02T15:04:05Z07:00&size=100&page=1" \
  --header "Authorization: Bearer sk-xx"

响应示例（200 OK）

{
  "status": true,
  "data": {
    "logs": [
      {
        "id": "xxx",
        "createdAt": "2006-01-02T15:04:05Z07:00",
        "model": "deepseek/deepseek-v3.1",
        "code": 200,
        "apikey": "sk-xx",
        "request": {},
        "response": {}
      }
    ],
    "total": 100
  }
}

响应字段说明：

字段	类型	说明
`status`	`boolean`	请求状态，`true` 表示成功
`data.logs`	`array`	请求日志列表
`data.logs[].id`	`string`	日志 ID
`data.logs[].createdAt`	`string`	请求时间（ISO 8601 格式）
`data.logs[].model`	`string`	使用的模型名称
`data.logs[].code`	`integer`	HTTP 状态码
`data.logs[].apikey`	`string`	使用的 APIKey
`data.logs[].request`	`object`	请求详情
`data.logs[].response`	`object`	响应详情
`data.total`	`integer`	总记录数

错误状态码

状态码	说明
400	请求参数错误（如时间范围超出限制、size 超出范围等）
401	认证失败（签名无效或 APIKey 无效）
403	权限不足
500	服务器内部错误

代码示例

使用 APIKey 认证导出日志

curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=100&page=1" \
  --header "Authorization: Bearer sk-xx"

使用 AK/SK 签名认证导出日志

curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=100&page=1&model=deepseek/deepseek-v3.1" \
  --header "Authorization: Qiniu <AccessKey>:<EncodedSign>"

导出文件版本

如需导出为文件，将路径中的 export_log 改为 export_log_file，其余参数不变：

curl --location "https://api.qnaigc.com/v2/stat/export_log_file?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=100&page=1" \
  --header "Authorization: Bearer sk-xx"

分批导出大量数据示例

如果需要导出 1500 条数据，需要分 3 次请求（每次最多 500 条）：

# 第 1 批：page=1, size=500
curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=500&page=1" \
  --header "Authorization: Bearer sk-xx"

# 第 2 批：page=2, size=500
curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=500&page=2" \
  --header "Authorization: Bearer sk-xx"

# 第 3 批：page=3, size=500
curl --location "https://api.qnaigc.com/v2/stat/export_log?start=2024-01-01T00:00:00Z&end=2024-01-08T00:00:00Z&size=500&page=3" \
  --header "Authorization: Bearer sk-xx"

`注意事项`

时间范围限制：
- start 和 end 最多相差 7 天（用于精确查询）
- end 和 start 最多相差 35 天（用于范围查询）
size 参数范围： 1~500，超出范围将返回错误。
如需导出超过 500 条数据： 请使用 page 参数分批请求，每次请求时保持其他参数不变，只修改 page 值。
如需导出为文件格式： 请将路径中的 export_log 改为 export_log_file，其余参数和请求方式不变。
默认按照请求时间倒排，不支持排序设置。
时间格式为 ISO 8601 格式：2006-01-02T15:04:05Z07:00。
数字签名生成算法可参考文档站中批量生成apikey部分。

以上内容是否对您有帮助？

AI 大模型推理