TokenLab

Quản lý

Cập nhật API Key

Cập nhật API key trong Workspace hiện tại.

PATCHhttps://api.tokenlab.sh/v1/management/api-keys/{keyId}

Tổng quan

Sử dụng endpoint này để cập nhật tên, giới hạn sử dụng, các model được phép, thời hạn hết hạn hoặc trạng thái của một user API key hiện có.

Phần thân yêu cầu (Request Body)

Phải cung cấp ít nhất một trường.

TrườngKiểu dữ liệuMặc định / Giới hạnGhi chú
statusenum-active, inactive, revoked
namestringđộ dài 1-50Tên hiển thị được cập nhật
limitAmountnumber | string | null0–100000 USDnull 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.
limitCurrencyenummặc định USDChỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired. Khi được thiết lập, bắt buộc phải có limitAmount.
modelsstring[]-Danh sách cho phép (allowlist) model được cập nhật
deliveryPolicystring | nullauto, verified, official, nullnull kế thừa delivery policy của Workspace.
expiresAtstring | nullthời gian theo chuẩn RFC3339null sẽ xóa thời hạn hết hạn

Lưu ý

  • Các trường tiền tệ chỉ hỗ trợ USD. Giá trị đầu vào CNY đã ngừng hoạt động và sẽ trả về 400 currency_retired.

  • Management API không cung cấp tính năng xóa. Sử dụng inactive để tạm dừng tạm thời và revoked để hủy bỏ vĩnh viễn một key.

  • Hãy thay thế key đã bị thu hồi bằng một key mới. Việc thiết lập một key đã thu hồi thành active sẽ trả về 409 api_key_revoked.

  • suspended có thể xuất hiện trong phản hồi, nhưng bạn không thể gửi giá trị này.

Ví dụ

Yêu cầu

cURL
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 lược đồ OpenAPI và các ví dụ request có thể sao chép. Gửi các request quản lý 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.

Ví dụ phản hồi

Phản hồi

200 OK
{
  "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-sonnet-4-6"
  ],
  "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

idstring
Định danh API key được sử dụng trong các lệnh gọi Management API tiếp theo.
namestring
Tên hiển thị cho API key.
key_prefixstring
Tiền tố key không bảo mật dùng để hiển thị và hỗ trợ kỹ thuật.
statusstring
Một trong các giá trị active, inactive, suspended, hoặc revoked.
limit_amountnumber | null
Hạn mức chi tiêu bằng USD dưới dạng số JSON để hiển thị. null nghĩa là không giới hạn.
limit_amount_decimalstring | null
Hạn mức chi tiêu chính xác bằng USD dưới dạng chuỗi số thập phân. null nghĩa là không giới hạn.
used_amountnumber
Mức sử dụng tích lũy bằng USD dưới dạng số JSON để hiển thị.
used_amount_decimalstring
Mức sử dụng tích lũy chính xác bằng USD dưới dạng chuỗi số thập phân.
modelsstring[]
Danh sách cho phép (allowlist) model theo từng key. Mảng rỗng nghĩa là không có giới hạn model bổ sung ở cấp độ key.
delivery_policystring | null
auto, verified, official, null. null kế thừa delivery policy của Workspace.
expires_atstring | null
Dấu thời gian ISO khi key hết hạn, hoặc null nếu không có thời hạn.
last_used_atstring | null
Dấu thời gian ISO cho lần sử dụng gần đây nhất, hoặc null khi chưa từng được sử dụng.
created_atstring
Dấu thời gian ISO khi tạo.

Xác thực

ManagementTokenAuth
AuthorizationBearer <token>

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

keyId*string

Nội dung yêu cầu

application/json

Phải cung cấp ít nhất một trường.

Thuộc tính1 <= properties

Phản hồi

application/json

application/json

application/json

application/json

application/json

application/json