管理密钥

列出 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 时，如果调用者是该组织的 org_admin 或 billing_viewer，可以指定组织 ID 列出该组织的密钥。组织 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
    }
  ]
}