Chuyển đến nội dung chính

​
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ú
namestringbắt buộc, mặc định Default Key, độ dài 1-50Tên hiển thị, server sẽ trim khoảng trắng
limitAmountnumber | nulltối thiểu 0, input tối đa 1000000null hoặc bỏ qua = 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
limitCurrencyenumdefault 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
expiresAtstring | nulldatetime RFC3339null nghĩa là không hết hạn

​
Ghi Chú

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

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

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

​
Response example

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

​
Important fields

​
key
string
Full secret API key value. It is returned only once on creation.
​
id
string
API key identifier used in follow-up Management API calls.
​
name
string
Display name for the API key.
​
key_prefix
string
Non-secret key prefix for display and support.
​
status
string
One of active, inactive, or revoked.
​
limit_amount
number | null
Spending cap in USD as a JSON number for display. null means unlimited.
​
limit_amount_decimal
string | null
Exact spending cap in USD as a decimal string. null means unlimited.
​
used_amount
number
Accumulated usage in USD as a JSON number for display.
​
used_amount_decimal
string
Exact accumulated usage in USD as a decimal string.
​
models
string[]
Per-key model allowlist. Empty array means no additional key-level model restriction.
​
expires_at
string | null
ISO timestamp when the key expires, or null for no expiry.
​
last_used_at
string | null
ISO timestamp for the most recent use, or null when unused.
​
created_at
string
ISO creation timestamp.