管理金鑰

列出 API 金鑰

列出呼叫者可管理的 API 金鑰。使用組織 Management Key 時，只會列出該金鑰所屬組織的金鑰，絕不會列出擁有者的個人金鑰或其他組織的金鑰。一般 sk-bl- 金鑰不能呼叫此管理端點；登入的 session cookie 也可供網頁儀表板使用。每個 keys[] 項目都包含 limit、limit_remaining、limit_reset、usage、usage_daily/weekly/monthly、requests、requests_daily/weekly/monthly，以及 usage_scope: key。這些數字與使用該金鑰呼叫 GET /v1/key 的數字一致。limit_remaining 有個別限額時是扣除該限額重設週期花費後的餘額，沒有個別限額時則是該金鑰所使用的帳戶或組織餘額。金鑰祕密值永遠不會回傳。要看組織總額再看每把金鑰的範例，請參考 GET /v1/key 頁面的管理金鑰範例。

GET/v1/keys

驗證

Authorization必填

string · header

在 Authorization 標頭以 Bearer token 傳入 API 金鑰。

查詢參數

orgId

string

使用 session cookie 時，可指定組織 ID 來列出該組織金鑰；呼叫者必須是該組織的 org_admin 或 billing_viewer。組織 Management Key 只能列出它自己所屬的組織，不能用這個參數切換組織。

GET /v1/keys

1
2
curl https://api.bazaarlink.ai/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

回應範例

成功。keys[] 依建立時間由新到舊排列；回傳金鑰中繼資料與每把金鑰自己的使用量，不回傳祕密值。

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
28
29
30
31
32
33
34
35
{
  "keys": [
    {
      "id": "key_demo_01",
      "name": "worker-a",
      "keyPrefix": "demo_",
      "keySuffix": "01",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 73,
      "totalTokens": 48200,
      "lastUsed": "2026-09-30T02:14:00.000Z",
      "createdAt": "2026-09-01T00:00:00.000Z",
      "spendLimitUsd": 10,
      "spendLimitPeriod": "day",
      "limit": 10,
      "limit_remaining": 7.88,
      "limit_reset": "day",
      "usage": 24.41,
      "usage_daily": 2.12,
      "usage_weekly": 5.64,
      "usage_monthly": 9.37,
      "requests": 314,
      "requests_daily": 18,
      "requests_weekly": 61,
      "requests_monthly": 205,
      "usage_scope": "key",
      "allowedModels": null,
      "expiresAt": null,
      "organizationId": "org_demo_01",
      "teamId": null,
      "orgMemberId": null
    }
  ]
}