Tạo API key

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

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

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ường	Kiểu	Mặc định / Giới hạn	Ghi chú
`name`	string	bắt buộc, mặc định `Default Key`, độ dài `1-50`	Tên hiển thị, máy chủ sẽ loại bỏ khoảng trắng ở đầu và cuối
`limitAmount`	number \| null	tối thiểu `0`, input tối đa `1000000`	`null` 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
`limitCurrency`	enum	mặc định `USD`	Chỉ hỗ trợ USD. Gửi `CNY` sẽ trả về `400 currency_retired`.
`models`	string[]	mặc định `[]`	Danh sách cho phép model tùy chọn
`expiresAt`	string \| null	datetime RFC3339	`null` 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ụ

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.

Ví dụ phản hồi

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

Các trường quan trọng

string

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.

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ý

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