Manajemen

Buat API Key

Buat API key untuk Workspace saat ini.

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

Gambaran Umum

Buat API key di Workspace yang terkait dengan management token. Secret lengkap hanya muncul satu kali, dalam respons ini.

Body Permintaan

FieldTipeDefault / BatasCatatan
namestringopsional, default Default Key, panjang 1-50Nama tampilan, dipangkas di sisi server
limitAmountnumber | string | null0–100000 USDnull berarti tidak terbatas; 0 mencegah pengeluaran. String desimal mendukung hingga 6 tempat desimal. Mengosongkan field ini saat membuat key berarti tidak terbatas.
limitCurrencyenumdefault USDHanya USD. Mengirimkan CNY akan mengembalikan 400 currency_retired.
modelsstring[]default []Allowlist model opsional
deliveryPolicystring | nullauto, verified, official, nullnull mewarisi delivery policy Workspace.
expiresAtstring | nulldatetime RFC3339null berarti tidak ada kedaluwarsa

Catatan

  • Field moneter hanya untuk USD. Input CNY sudah dihentikan dan mengembalikan 400 currency_retired.

  • models: [] tidak menambahkan pembatasan model tingkat key.

  • limitAmount: 0 membuat key yang valid tetapi tidak dapat membelanjakan kuota hingga diperbarui.

Contoh

Permintaan

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

Permintaan / Respons

Halaman ini menyediakan skema OpenAPI dan contoh request yang dapat disalin. Kirim request manajemen dari terminal atau klien Anda dengan Management Token; pengiriman langsung tidak tersedia di halaman ini.

Contoh Respons

Respons

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
}

Field penting

keystring
Nilai API key rahasia lengkap. Nilai ini hanya dikembalikan satu kali saat pembuatan.
idstring
Pengidentifikasi API key yang digunakan dalam panggilan Management API berikutnya.
namestring
Nama tampilan untuk API key.
key_prefixstring
Prefiks key non-rahasia untuk tampilan dan dukungan.
statusstring
Salah satu dari active, inactive, suspended, atau revoked.
limit_amountnumber | null
Batas pengeluaran dalam USD sebagai angka JSON untuk tampilan. null berarti tidak terbatas.
limit_amount_decimalstring | null
Batas pengeluaran tepat dalam USD sebagai string desimal. null berarti tidak terbatas.
used_amountnumber
Penggunaan akumulasi dalam USD sebagai angka JSON untuk tampilan.
used_amount_decimalstring
Penggunaan akumulasi tepat dalam USD sebagai string desimal.
modelsstring[]
Allowlist model per-key. Array kosong berarti tidak ada pembatasan model tingkat key tambahan.
delivery_policystring | null
auto, verified, official, null. null mewarisi delivery policy Workspace.
expires_atstring | null
Timestamp ISO saat key kedaluwarsa, atau null jika tidak ada kedaluwarsa.
last_used_atstring | null
Timestamp ISO untuk penggunaan terbaru, atau null jika belum digunakan.
created_atstring
Timestamp pembuatan ISO.

Otorisasi

ManagementTokenAuth
AuthorizationBearer <token>

Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.

Lokasi: header

Body permintaan

application/json

Respons

application/json

application/json

application/json

application/json