导出日志

GET /api/open/v1/logs/export

一次性返回全部匹配的日志，不分页。筛选条件与查询账户日志相同，响应体是 CSV 或 JSONL 文件。

请求参数

参数	位置	类型	必填	默认值	说明
`start_timestamp`	query	integer	否	见说明	起始时间（含），unix 秒
`end_timestamp`	query	integer	否	见说明	结束时间（含），unix 秒
`type`	query	integer	否	`2`	日志类型：`2` 消费（计费）请求，`7` 最终失败请求（不计费）。多值需重复参数或逗号分隔（`?type=2,7`）；其他值返回 400
`model_name`	query	string	否	—	按模型名精确过滤；多值需重复参数（`?model_name=a&model_name=b`），也支持逗号分隔
`key_name`	query	string	否	—	按 Key 名称精确过滤；多值需重复参数，不支持逗号分隔（名称本身可能含逗号）
`key_id`	query	integer	否	—	Key ID，正整数；多值需重复参数或逗号分隔。其他用户的 Key ID 只会返回空
`format`	query	string	否	`csv`	导出格式：`csv` 或 `jsonl`；其他值返回 400

时间范围规则：

两端都省略：最近 30 天。
只传 start_timestamp：向后 30 天，且不超过当前时间。
只传 end_timestamp：向前 30 天。
范围最长 366 天。

多值参数每个最多 50 个值，超过返回 400 invalid_request。时间参数必须是非负整数，否则返回 400。本接口不接受 p / page_size。

请求示例

curl "https://www.routeapi.ai/api/open/v1/logs/export?start_timestamp=1726408000&end_timestamp=1729000000&key_name=bot&type=2,7&format=csv" \
  -H "Authorization: Bearer $ROUTEAPI_MANAGEMENT_KEY" \
  -o logs.csv

响应

响应体是导出文件，不是通常的 { success, message, data } JSON。响应头：

响应头	说明
`X-Export-Rows`	本次写入文件的行数
`X-Export-Truncated`	匹配行数超过单次上限时为 `true`，否则为 `false`
`Cache-Control`	恒为 `no-store`
`Content-Disposition`	`attachment; filename="logs-<UTC yyyyMMdd-HHmmss>.csv"` 或 `.jsonl`

单次最多返回 50000 行。匹配超过 50000 行时，按日志 ID 倒序取最新的 50000 行，并置 X-Export-Truncated: true；需要其余数据时把时间范围拆小、分批导出。与查询账户日志不同，本接口按日志 ID 倒序（id desc）排列。

CSV 格式

format=csv 返回 Content-Type: text/csv; charset=utf-8，以 UTF-8 BOM 开头，随后是表头与每行一条日志。列顺序固定为：

id,created_at,type,key_id,key_name,model_name,prompt_tokens,completion_tokens,total_tokens,amount,request_id,key,use_time,is_stream,first_response_ms,cache_read_tokens,cache_creation_tokens,reasoning_effort,request_path,web_search_calls,audio_input_tokens,audio_output_tokens,billing_source
12345,1729000000,2,12,bot,gpt-4o,1200,300,1500,0.05,20261020120000123456789,sk-abcd**********wxyz,3,true,420,800,0,medium,/v1/chat/completions,0,0,0,wallet

字段与查询账户日志的 item 一致，created_at 为 unix 秒。以 =、+、@、制表符或回车开头的单元格，以及以非数字 - 开头的单元格，会加前缀 '，防止表格软件把内容当公式执行。

JSONL 格式

format=jsonl 返回 Content-Type: application/x-ndjson，每行一个 JSON 对象，字段与查询账户日志的 item 完全相同：

{"id":12345,"created_at":1729000000,"type":2,"key_id":12,"key_name":"bot","key":"sk-abcd**********wxyz","model_name":"gpt-4o","prompt_tokens":1200,"completion_tokens":300,"total_tokens":1500,"amount":0.05,"use_time":3,"is_stream":true,"first_response_ms":420,"cache_read_tokens":800,"cache_creation_tokens":0,"reasoning_effort":"medium","request_path":"/v1/chat/completions","web_search_calls":0,"audio_input_tokens":0,"audio_output_tokens":0,"billing_source":"wallet","request_id":"20261020120000123456789"}

错误

HTTP	code	场景
400	`invalid_request`	时间戳非数字或为负数、时间范围超过 366 天、`start_timestamp` 大于 `end_timestamp`、多值参数超过 50 个值、`key_id` 不是正整数、`type` 不是 `2` 或 `7`，或 `format` 不是 `csv` 或 `jsonl`
429	—	超过按用户的查询频率限制（默认 30 次/分钟），响应体可能为空

错误以普通 JSON 错误体返回，不是文件。其他通用错误码见开放平台 API 错误。

说明

默认只导出消费（计费）日志；需要同时包含最终失败请求（不计费）时传 type=2,7。
key_name 是请求发生时 Key 的名称；改名不会回溯改写历史记录。
key 是脱敏值；Key 被永久删除后为空字符串。
token 数为原始计数，不是百万单位。金额使用站点展示币种，见查询余额。
本接口与账户日志、用量统计、按模型统计、按 Key 统计共享按用户的查询频率限制（默认 30 次/分钟），见频率限制。