所有文档

Dashboard 总览 API

拉取密钥所属账户的汇总用量：总请求数、Token 数、14 天趋势、平均首字延迟。

端点

GET/api/v1/dashboard/overview

认证

支持两种身份：API Key（脚本推荐）或浏览器会话 JWT。API Key 优先校验。

1. API Key（自动化推荐）

在 x-api-key 头里带上密钥；要求状态为启用、未撤销且未过期。

bash
curl https://1024x.ai/api/v1/dashboard/overview \
  -H "x-api-key: nub_xxxxxxxxxxxxxxxxxxxx"

2. 会话 JWT（控制台使用）

Authorization: Bearer 是控制台前端走的方式，脚本一般不会用到。

bash
curl https://1024x.ai/api/v1/dashboard/overview \
  -H "Authorization: Bearer $SESSION_JWT"

响应

json
{
  "totalRequests": 12834,
  "totalTokens": 4827193,
  "avgLatencyMs": 612,
  "series": [
    { "date": "04-30", "tokens": 142903, "requests": 412 },
    { "date": "05-01", "tokens": 188211, "requests": 503 },
    // ... 14 days total, oldest first
    { "date": "05-13", "tokens": 95412,  "requests": 287 }
  ]
}
字段类型说明
totalRequestsnumber本月请求数（含失败）。
totalTokensnumber本月 Token 总数（input + output + cache）。
avgLatencyMsnumber (ms)本月平均首字 token 延迟（TTFT）；非流式请求不计入。
series[]{date,tokens,requests}14 天的每日 Token 与请求数，按时间升序；date 为 MM-DD。

注意事项

  • 响应在服务端按账户缓存约 2 分钟。
  • 禁用或过期的密钥会返回字段为空 / 0 的响应而不是 401，以避免暴露密钥是否存在。
  • 具体成本与按 Key 维度的明细在 /ai/v1/usage/stats，需要按 Key 拆分或拿到美元金额时走那个端点。