管理密钥

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