第4章 API 使用量统计与摘要接口指南
欲查看完整文档索引,请参见 llms.txt。此页面亦可作为 Markdown 格式获取。使用量获取使用量统计获取获取 API 密钥所属组织的每日使用量统计。返回分页的每日使用量统计数据,支持按日期范围、模型、供应商及来源进行可选筛选。每条记录代表特定用户/模型/供应商/来源组合在某一天的聚合使用量。查询参数start_date字符串 · 日期时间可选筛选起始日期(ISO 格式)end_date字符串 · 日期时间可选筛选结束日期(ISO 格式)model字符串可选按特定模型筛选model_provider字符串可选按模型供应商筛选source字符串可选按来源筛选(api 或 app)limit整数 · 最小值: 1 · 最大值: 1000可选返回的记录数默认值: 100offset整数可选跳过的记录数默认值: 0响应200成功响应application/json每日使用量统计的 API 响应模型。id字符串 · uuid必填user_id字符串 · uuid必填org_id字符串 · uuid必填email字符串必填model字符串必填source字符串必填input_tokens整数必填output_tokens整数必填total_tokens整数必填total_requests整数必填date字符串 · 日期时间必填created_at字符串 · 日期时间必填401认证失败application/json422参数无效application/json500服务器错误application/jsonget/api/v1/usage/statsGET /api/v1/usage/stats HTTP/1.1 Accept: */* [ { "id": "123e4567-e89b-12d3-a456-426614174000", "user_id": "123e4567-e89b-12d3-a456-426614174000", "org_id": "123e4567-e89b-12d3-a456-426614174000", "email": "text", "model": "text", "source": "text", "input_tokens": 1, "output_tokens": 1, "total_tokens": 1, "total_requests": 1, "date": "2026-01-01T00:00:00.000Z", "created_at": "2026-01-01T00:00:00.000Z" } ]获取使用量摘要获取获取 API 密钥所属组织的聚合使用量摘要统计。返回高级指标,包括总 Token 数、请求数、独立用户数、模型数、供应商数,以及 API 与应用使用量的细分数据。查询参数start_date字符串 · 日期时间可选摘要起始日期(ISO 格式)end_date字符串 · 日期时间可选摘要结束日期(ISO 格式)响应200成功响应application/json聚合使用量摘要的 API 响应模型。total_input_tokens整数必填total_output_tokens整数必填total_tokens整数必填total_requests整数必填unique_users整数必填unique_models整数必填unique_providers整数必填api_usage整数必填app_usage整数必填date_range_days整数必填401认证失败application/json422参数无效application/json500服务器错误application/jsonget/api/v1/usage/summaryGET /api/v1/usage/summary HTTP/1.1 Accept: */* { "total_input_tokens": 1, "total_output_tokens": 1, "total_tokens": 1, "total_requests": 1, "unique_users": 1, "unique_models": 1, "unique_providers": 1, "api_usage": 1, "app_usage": 1, "date_range_days": 1 }上一项:聊天补全下一项:模型列表最后更新于 8 个月前