ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

管理APIキー

管理キーはプログラマティックなキー管理用に設計されています。標準APIキーの作成、一覧表示、更新、無効化、削除ができますが、AIモデルの呼び出しはできません。

注意

管理キーではAIモデル（chat/completions/messages/embeddings）を呼び出せません。モデルアクセスには標準APIキーを使用してください。

管理キーの作成

Management API Keys ページに移動し、「Create」をクリックしてください — 通常の API Keys ページ内のタイプ選択ではなく、専用の別ページです。

キー一覧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
GET https://api.bazaarlink.ai/v1/keys
Authorization: Bearer sk-bl-YOUR_MGMT_KEY

# Response
{
"keys": [
  {
    "id": "clxyz123...",
    "name": "Production Key",
    "keyType": "standard",
    "keyPrefix": "sk-bl-abc1",
    "keySuffix": "XyZ9",
    "enabled": true,
    "spendLimitUsd": 10.00,
    "spendLimitPeriod": "month",
    "expiresAt": null,
    "createdAt": "2026-01-01T00:00:00.000Z",
    "lastUsed": "2026-03-01T12:34:56.000Z",
    "requestCount": 1234,
    "totalTokens": 5678901
  }
]
}

サブキーの作成

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
POST https://api.bazaarlink.ai/v1/keys
Authorization: Bearer sk-bl-YOUR_MGMT_KEY
Content-Type: application/json

{
"name": "Agent Key",
"limit": 10.00,
"limit_reset": "monthly",
"expires_at": "2026-12-31T23:59:59Z"
}

# limit_reset: daily | weekly | monthly
# expires_at:  ISO 8601 datetime (optional)

# Response — save the key value, it won't be shown again
{
"id": "clxyz789...",
"name": "Agent Key",
"key": "sk-bl-xyz789abcdef...",
"keyType": "standard",
"spendLimitUsd": 10.00,
"spendLimitPeriod": "month",
"expiresAt": "2026-12-31T23:59:59.000Z",
"enabled": true,
"createdAt": "2026-03-01T00:00:00.000Z"
}

キーの更新

1
2
3
4
5
6
7
8
PATCH https://api.bazaarlink.ai/v1/keys/:id
Authorization: Bearer sk-bl-YOUR_MGMT_KEY
Content-Type: application/json

{"enabled": false}              # disable key
{"spendLimitUsd": 5, "spendLimitPeriod": "week"}  # set spend limit
{"spendLimitUsd": null}         # remove spend limit
# Response: {"updated": true}

キーの取り消し

1
2
3
4
DELETE https://api.bazaarlink.ai/v1/keys/:id
Authorization: Bearer sk-bl-YOUR_MGMT_KEY

# Returns 204 No Content on success

残高照会

1
2
3
4
5
6
7
8
9
10
GET https://api.bazaarlink.ai/v1/credits
Authorization: Bearer sk-bl-YOUR_MGMT_KEY

# Response
{
"data": {
  "total_credits": 12.345,
  "total_usage": 3.210
}
}

使用量照会

1
2
3
4
GET https://api.bazaarlink.ai/v1/usage?period=month
Authorization: Bearer sk-bl-YOUR_MGMT_KEY

# period: day | week | month | year