管理密钥

获取 API 密钥活动

返回单个 API 密钥在指定周期内的活动统计。period 可选 day、week、month 或 year，所有边界都按 UTC 计算：每天 UTC 00:00、每周一 UTC 00:00、每月 1 日 UTC 00:00、每年 1 月 1 日 UTC 00:00。使用组织 Management Key 时，只能查询同一组织的密钥。返回的是该密钥自己的花费、请求数、token 数、模型分组和时间序列，不是组织总额；超出调用者范围的密钥返回 404。使用 format=csv 可导出 CSV。

GET/v1/keys/:id/activity

验证

Authorization必填

string · header

在 Authorization 标头以 Bearer token 传入 API 密钥。

路径参数

id必填

string

要查询活动的 API 密钥 ID。

查询参数

period

string

统计周期。day、week、month 和 year 都使用 UTC 边界；默认为 month。

dayweekmonthyear

format

string

可选。设置为 csv 时返回 CSV 导出；省略时返回 JSON。

csv

GET /v1/keys/:id/activity

1
2
curl "https://api.bazaarlink.ai/v1/keys/key_demo_01/activity?period=month" \
  -H "Authorization: Bearer $BAZAARLINK_MANAGEMENT_KEY"

响应示例

成功。totals 包含该密钥在周期内的花费、请求数和 token 数。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
{
  "keyName": "worker-a",
  "period": "month",
  "since": "2026-09-01T00:00:00.000Z",
  "totals": {
    "spend": 9.37,
    "requests": 205,
    "tokens": 48200
  },
  "byModel": [
    {
      "model": "example-model",
      "spend": 9.37,
      "tokens": 48200,
      "requests": 205
    }
  ],
  "timeSeries": [
    {
      "date": "2026-09-30",
      "model": "example-model",
      "cost": 2.12,
      "tokens": 10400,
      "requests": 18
    }
  ]
}