管理金鑰

取得 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
    }
  ]
}