管理金鑰

列出 API 金鑰

列出目前使用者(或指定組織)名下的標準 API 金鑰。這是管理端點,呼叫時若用 Bearer token 認證,該金鑰必須是 Management API Key,一般的 sk-bl- 金鑰打不了這支;也可用登入後的 session cookie 呼叫(給前台網頁用)。回應絕不含金鑰明文,只有 prefix/suffix。

GET/api/v1/keys

驗證

Authorization必填

string · header

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

查詢參數

orgId

string

列出整個組織的金鑰,而非只列呼叫者個人的金鑰。呼叫者必須在該組織是 org_admin 或 billing_viewer,否則回 403。

GET /api/v1/keys

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

回應範例

成功。keys[] 依建立時間新到舊排序,每筆含用量統計、支出上限、組織範圍與訂閱方案(若有)——絕不含金鑰明文本身。limitRemainingUsd 是依這把金鑰自己的重置週期算好的剩餘額度(無上限時為 null);usageDailyUsd/usageWeeklyUsd/usageMonthlyUsd 是固定日曆區間(不受 spendLimitPeriod 影響)的花費拆分。

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
{
  "keys": [
    {
      "id": "key_abc123",
      "name": "production",
      "keyPrefix": "sk-bl-",
      "keySuffix": "hDS5",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 1204,
      "totalTokens": 892340,
      "lastUsed": "2026-07-27T03:12:00.000Z",
      "createdAt": "2026-05-01T00:00:00.000Z",
      "spendLimitUsd": 50,
      "spendLimitPeriod": "month",
      "allowedModels": null,
      "expiresAt": null,
      "subscriptionPlanId": null,
      "subscriptionStatus": null,
      "subscriptionStartedAt": null,
      "organizationId": null,
      "teamId": null,
      "orgMemberId": null,
      "subscriptionPlan": null,
      "periodSpendUsd": 4.82,
      "limitRemainingUsd": 45.18,
      "usageDailyUsd": 0.4,
      "usageWeeklyUsd": 2.1,
      "usageMonthlyUsd": 4.82
    }
  ]
}