TokenLab
Lấy khóa API
Tài liệuTham chiếu APITích hợp

Quản lý

Tạo API key

Tạo một API key người dùng mới cho tổ chức hiện tại.

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

Tổng Quan

Tạo một API key type=user mới trong tổ chức gắn với management token hiện tại.

Thân Yêu Cầu

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ị, máy chủ sẽ loại bỏ khoảng trắng ở đầu và cuối
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. Khi tạo khóa, bỏ qua trường này nghĩa là 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 model tùy chọn
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 nghĩa là không 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.

  • Giá trị đầy đủ của API key chỉ hiển thị một lần trong response.

  • models: [] nghĩa là key không có hạn chế model bổ sung nào ngoài chính sách của tổ chức.

  • limitAmount: 0 tạo ra một key hợp lệ nhưng chưa thể chi tiêu quota 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-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

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

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-3.0-video"
  ],
  "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ị bí mật đầy đủ của khóa API. Giá trị này chỉ được trả về một lần khi tạo.
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

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json

application/json

application/json

Liệt kê API Keys

Trước

Cập Nhật API key

Tiếp