Quản lý
Tạo API Key
Tạo một API key cho Workspace hiện tại.
Tổng quan
Tạo một API key trong Workspace được liên kết với management token. Toàn bộ secret chỉ xuất hiện một lần duy nhất trong phản hồi này.
Phần thân yêu cầu (Request Body)
| Trường | Kiểu | Mặc định / Giới hạn | Ghi chú |
|---|---|---|---|
name | string | tùy chọn, mặc định Default Key, độ dài 1-50 | Tên hiển thị, được cắt tỉa khoảng trắng ở phía server |
limitAmount | number | string | null | 0–100000 USD | null có nghĩa là không giới hạn; 0 ngăn chặn chi tiêu. Chuỗi số thập phân hỗ trợ tối đa 6 chữ số thập phân. Bỏ qua trường này khi tạo key đồng nghĩa với không giới hạn. |
limitCurrency | enum | mặc định USD | Chỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired. |
models | string[] | mặc định [] | Danh sách cho phép (allowlist) model tùy chọn |
deliveryPolicy | string | null | auto, verified, official, null | null kế thừa delivery policy của Workspace. |
expiresAt | string | null | RFC3339 datetime | null có nghĩa là không có hạn dùng |
Ghi chú
-
Các trường tiền tệ chỉ hỗ trợ USD. Đầu vào
CNYđã ngừng hỗ trợ và trả về400 currency_retired. -
models: []không áp dụng giới hạn model nào ở cấp độ key. -
limitAmount: 0tạo một key hợp lệ nhưng không thể chi tiêu hạn ngạch cho đến khi được cập nhật.
Yêu cầu
curl -X POST "https://api.tokenlab.sh/v1/management/api-keys" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"name": "Backend Worker",
"limitAmount": 500,
"models": ["veo3.1", "kling-v3.0"],
"expiresAt": "2026-12-31T23:59:59Z"
}'Yêu cầu / Phản hồi
Trang này cung cấp OpenAPI schema và các ví dụ request có thể sao chép. Gửi các management request từ terminal hoặc client của bạn bằng Management Token; tính năng gửi trực tiếp không khả dụng trên trang này.
Phản hồi
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key": "sk-live-redacted",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 0,
"used_amount_decimal": "0",
"models": [
"veo3.1",
"kling-v3.0"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": null,
"created_at": "2026-07-08T03:00:00.000Z",
"delivery_policy": null
}Các trường quan trọng
active, inactive, suspended, hoặc revoked.null có nghĩa là không giới hạn.null có nghĩa là không giới hạn.auto, verified, official, null. null kế thừa delivery policy của Workspace.null nếu không có hạn dùng.null khi chưa từng sử dụng.Xác thực
ManagementTokenAuth Xác thực bằng Token quản lý. Tạo hoặc quản lý Token quản lý trong Dashboard > API > Management Tokens.
Vị trí: header
Nội dung yêu cầu
application/json
Phản hồi
application/json
application/json
application/json
application/json