Cập Nhật API key

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

{
  "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-mini",
    "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"
}

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 \| null	tối thiểu `0`, input tối đa `1000000`	`null` = không giới hạn, `0` = quota bằng 0. Giá trị dương được chuẩn hoá thành trần lưu trữ không vượt quá tương đương `100000` USD
`limitCurrency`	enum	mặc định `USD`	Chỉ hỗ trợ USD. Gửi `CNY` sẽ trả về `400 currency_retired`.
`models`	string[]	-	Danh sách cho phép model đã cập nhật
`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.
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ụ

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

Sử dụng bảng OpenAPI tương tác ở trên để xem schema và các trường response chính xác.

Ví dụ 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-mini",
    "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"
}

Các trường quan trọng

string

Mã định danh khóa API dùng trong các lệnh gọi API Quản lý tiếp theo.

string

Tên hiển thị của khóa API.

string

Tiền tố khóa không bí mật để hiển thị và hỗ trợ.

string

Một trong các giá trị active, inactive hoặc revoked.

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

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

number

Chi phí sử dụng tích lũy bằng USD dưới dạng số JSON để hiển thị.

string

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.

string[]

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.

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

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

string

Dấu thời gian ISO khi tạo.

Cốt lõi

Văn bản

Tệp và lô

Hình ảnh

Âm thanh & thời gian thực

Âm nhạc

Video & tư liệu

Worlds

3D

Tác vụ bất đồng bộ

Gemini gốc

Quản lý

Cập Nhật API key

Tổng Quan

Thân Yêu Cầu

Ghi Chú

Ví Dụ

Yêu Cầu / Phản Hồi

Ví dụ phản hồi

Các trường quan trọng

​Tổng Quan

​Thân Yêu Cầu

​Ghi Chú

​Ví Dụ

​Yêu Cầu / Phản Hồi

​Ví dụ phản hồi

​Các trường quan trọng

Tổng Quan

Thân Yêu Cầu

Ghi Chú

Ví Dụ

Yêu Cầu / Phản Hồi

Ví dụ phản hồi

Các trường quan trọng