TokenLab

Quản lý

Tạo API Key

Tạo một API key cho Workspace hiện tại.

POSThttps://api.tokenlab.sh/v1/management/api-keys

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ườngKiểuMặc định / Giới hạnGhi chú
namestringtùy chọn, mặc định Default Key, độ dài 1-50Tên hiển thị, được cắt tỉa khoảng trắng ở phía server
limitAmountnumber | string | null0–100000 USDnull 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.
limitCurrencyenummặc định USDChỉ hỗ trợ USD. Gửi CNY sẽ trả về 400 currency_retired.
modelsstring[]mặc định []Danh sách cho phép (allowlist) model tùy chọn
deliveryPolicystring | nullauto, verified, official, nullnull kế thừa delivery policy của Workspace.
expiresAtstring | nullRFC3339 datetimenull 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: 0 tạ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.

Ví dụ

Yêu cầu

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

Ví dụ phản hồi

Phản hồi

201 Created
{
  "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

keystring
Giá trị secret API key đầy đủ. Giá trị này chỉ được trả về một lần duy nhất khi tạo.
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 cho việc 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 có 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 có 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 thập phân.
modelsstring[]
Danh sách cho phép (allowlist) model theo từng key. Mảng trống nghĩa là không có thêm hạn chế model ở 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ó hạn dùng.
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 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

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json