导出 Usage 使用明细
模融导出 Usage 使用明细 参考。
导出 Usage 使用明细
使用明细属于控制台账户数据，不是模型网关 API Key 的查询接口。自动化导出需要以账户登录身份访问用户 API，并应保护登录令牌与导出文件。
1. 接口总览
| 项目 | 值 |
|---|---|
| Base URL | https://mrxapi.com |
| 登录 | POST /api/v1/auth/login |
| 明细 | GET /api/v1/usage |
| 鉴权 | 账户 access token，而非模型 API Key |
| 返回 | JSON；字段和分页信息以实际响应为准 |
2. 第一步：登录获取访问令牌
通过站点登录流程或你的受控后端获取账户 access token。不要把账户密码、refresh token 或 access token 放在浏览器脚本、仓库或终端历史中。对于人工对账，优先使用控制台“使用记录”的导出能力。
3. 第二步：拉取使用明细
curl "https://mrxapi.com/api/v1/usage?page=1&page_size=100&start_date=2026-10-01&end_date=2026-10-31&timezone=Asia/Shanghai" \
-H "Authorization: Bearer $MRXAPI_ACCESS_TOKEN"4. Query 参数
| 参数 | 用途 |
|---|---|
page / page_size | 分页；从小时间段开始验证 |
start_date / end_date | 日期范围，使用 YYYY-MM-DD |
timezone | 解释日期边界的时区，例如 Asia/Shanghai |
api_key_id | 限定到当前账户拥有的 Key |
model | 按模型 ID 筛选 |
stream | 按流式或非流式筛选（若部署支持） |
sort_by / sort_order | 排序字段和方向（若部署支持） |
未被当前部署支持的参数会被忽略或报错，导出脚本需检查响应。
5. 响应与字段
响应通常包含分页信息和记录数组。记录可能包含模型、请求时间、请求类型、输入/输出 token、缓存 token、费用、流式标识、耗时、API Key 引用和 request id。字段会随平台和计费模式而变化；金额核对应使用同一时区、同一过滤条件，并以站点账单为准。
6. 翻页导出建议
按日期分片，每页处理后写入自己的受控存储。记录本次导出的时间范围、时区和筛选条件；避免并发抓取过多页面。网络失败后从已成功页继续，不要把重复数据直接追加进财务记录。
7. Token 续期
访问令牌过期时使用站点当前登录/刷新流程重新获取；不要把 refresh token 当作长期 API Key。服务端自动化应把账户令牌保存在受审计的密钥系统。
8. 常见错误
401 表示登录态缺失或过期；403 可能是尝试读取不属于当前账户的 Key；400 常见于日期、页码或时区格式不正确。提交排障信息时提供 request id 和脱敏参数，不要提供账户密码或 token。