AIin1Portal

查询用量

GET /api/v1/obs/usage

按日 / 按模型 / 按团队 / 按 Key 聚合查询组织的用量与消费。

鉴权：本接口属于控制台后端 API（Base URL https://portal.aiin1.ai，注意不是 api.portal.aiin1.ai），需携带控制台账号登录后获取的 access_token（15 分钟有效），不能使用 sk-nex- API 令牌。登录方式与完整自动对账实践见 账单对账与用量自动同步。

请求参数

参数 位置 类型 必填 说明
start / end query date 否 起止日期（YYYY-MM-DD，含两端），必须成对出现，跨度 ≤ 365 天，end 不能是未来日期。不传则使用 range_days
range_days query integer 否 最近 N 天（默认 7）
group query string 否 聚合维度：date（默认）/ model / team / key / owner；支持逗号组合做多维交叉（如 group=model,key），组合时 group_key / group_name 按顺序以 | 拼接
team_id query string(uuid) 否 按团队过滤
apikey_id query string(uuid) 否 按 API Key 过滤
model query string 否 按模型名过滤

请求示例

curl "https://portal.aiin1.ai/api/v1/obs/usage?start=2026-07-01&end=2026-07-31&group=model" \
  -H "Authorization: Bearer $ACCESS_TOKEN"

响应

返回数组，每行一个聚合分组：

字段 类型 说明
group_key string 聚合键（日期 / 模型名 / 团队或 Key 的 ID）
group_name string | null 聚合键的显示名
request_count integer 请求数
prompt_tokens integer 输入 token
completion_tokens integer 输出 token
cache_creation_input_tokens integer 缓存写入 token
cache_read_input_tokens integer 缓存命中 token
total_tokens integer 总 token
cost_usd string(decimal) 消费金额（USD）
avg_latency_ms integer | null 平均延迟（毫秒）
error_count integer 错误数

相关：逐笔明细导出

同前缀下还提供逐请求明细导出（参数 start / end 必填，可选 model / apikey_id / team_id 过滤）：

  • GET /api/v1/obs/usage/export — CSV（逐笔含当次单价与折扣系数，可独立复算 cost_usd）
  • GET /api/v1/obs/usage/export.xlsx — Excel 明细
  • GET /api/v1/obs/usage/stats.xlsx — Excel 统计

列说明见 账单对账与用量自动同步。