Quản lý
Cập Nhật API key
Cập nhật một API key người dùng hiện có cho tổ chức hiện tại.
Tổng Quan
Dùng endpoint này để cập nhật tên, giới hạn sử dụng, model được phép, thời hạn hết hạn hoặc trạng thái của một API key người dùng hiện có.
Thân Yêu Cầu
Phải cung cấp ít nhất một trường.
| Trường | Kiểu | Mặc định / Giới hạn | Ghi chú |
|---|---|---|---|
status | enum | - | active, inactive, revoked |
name | string | độ dài 1-50 | Tên hiển thị đã cập nhật |
limitAmount | number | string | null | 0–100000 USD | null nghĩa là không giới hạn; 0 ngăn phát sinh chi phí. Chuỗi thập phân hỗ trợ tối đa 6 chữ số sau dấu thập phân. |
limitCurrency | enum | mặc định USD | Chỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired. Khi được chỉ định, phải có cả limitAmount. |
models | string[] | - | Danh sách cho phép model đã cập nhật |
deliveryPolicy | string | null | auto, verified, official, null | null kế thừa chính sách cung cấp của không gian làm việc. |
expiresAt | string | null | datetime RFC3339 | null sẽ xoá thời hạn hết hạn |
Ghi Chú
-
Các trường tiền tệ chỉ hỗ trợ USD. Dữ liệu nhập
CNYđã bị ngừng hỗ trợ và trả về400 currency_retired. -
Hard delete không được hỗ trợ trong Management API v1.
-
revokedlà trạng thái kết thúc đối với thao tác vận hành thông thường; hãy tạo key mới thay vì mong đợi có luồng khôi phục sau này.
Yêu cầu
curl -X PATCH "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456" \
-H "Authorization: Bearer mt-your-management-token" \
-H "Content-Type: application/json" \
-d '{
"status": "inactive",
"limitAmount": 0
}'Yêu Cầu / Phản Hồi
Trang này cung cấp schema OpenAPI và các ví dụ yêu cầu có thể sao chép. Hãy gửi yêu cầu quản lý từ terminal hoặc ứng dụng khách bằng Management Token; trang này không hỗ trợ gửi trực tiếp.
Phản hồi
{
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "inactive",
"limit_amount": 0,
"limit_amount_decimal": "0",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-3-7-sonnet"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
}Các trường quan trọng
active, inactive, suspended hoặc revoked.null nghĩa là không giới hạn.null nghĩa là không giới hạn.auto, verified, official, null. null kế thừa chính sách cung cấp của không gian làm việc.null nếu không hết hạn.null nếu 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
Tham số đường dẫn
Nội dung yêu cầu
application/json
Phải cung cấp ít nhất một trường.
1 <= propertiesPhản hồi
application/json
application/json
application/json
application/json
application/json
application/json