TokenLab

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.

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

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ườngKiểuMặc định / Giới hạnGhi chú
statusenum-active, inactive, revoked
namestringđộ dài 1-50Tên hiển thị đã cập nhật
limitAmountnumber | string | null0–100000 USDnull 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.
limitCurrencyenummặc định USDChỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired. Khi được chỉ định, phải có cả limitAmount.
modelsstring[]-Danh sách cho phép model đã cập nhật
deliveryPolicystring | nullauto, verified, official, nullnull kế thừa chính sách cung cấp của không gian làm việc.
expiresAtstring | nulldatetime RFC3339null 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.

  • revoked là 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.

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 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.

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

idstring
Mã định danh khóa API dùng trong các lệnh gọi API Quản lý tiếp theo.
namestring
Tên hiển thị của khóa API.
key_prefixstring
Tiền tố khóa không bí mật để hiển thị và hỗ trợ.
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 thập phân. null nghĩa là không giới hạn.
used_amountnumber
Chi phí sử dụng tích lũy bằng USD dưới dạng số JSON để hiển thị.
used_amount_decimalstring
Chi phí sử dụng tích lũy chính xác bằng USD dưới dạng chuỗi thập phân.
modelsstring[]
Danh sách mô hình được phép cho từng khóa. Mảng rỗng nghĩa là không có hạn chế mô hình bổ sung ở cấp khóa.
delivery_policystring | 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.
expires_atstring | null
Dấu thời gian ISO khi khóa hết hạn, hoặc null nếu không hết hạn.
last_used_atstring | null
Dấu thời gian ISO của lần sử dụng gần nhất, hoặc null nếu chưa từng 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