Управление API Ключи

Ключи управления предназначены для программного управления ключами. Они могут создавать, перечислять, обновлять, отключать и удалять стандартные ключи API, но не могут вызывать модели ИИ.

Примечание

Клавиши управления не могут вызывать модели AI (chat/completions/messages/embeddings). Для доступа к модели используйте стандартный ключ API.

Создание ключа управления

Перейти вManagement API Страница ключейи нажмите «Создать» — это отдельная страница от ваших стандартных ключей API, а не селектор типа на той же странице.

Список ключей

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"
}

Update Key

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