Management Key

API キーのアクティビティを取得

指定期間における 1 つの API キーのアクティビティ統計を返します。period は day、week、month、year を指定でき、すべての境界は UTC です。日次は 00:00、週次は月曜 00:00、月次は各月 1 日の 00:00、年次は 1 月 1 日の 00:00 から始まります。組織の Management Key では同じ組織のキーだけを検索できます。返すのはそのキー自身の支出、リクエスト数、トークン数、モデル別内訳、時系列であり、組織全体の合計ではありません。範囲外のキーは 404 です。CSV は format=csv を指定してください。

GET/v1/keys/:id/activity

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして 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 には期間内のこのキーの支出、リクエスト数、トークン数が含まれます。

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