Buat API Key

Ikhtisar

Membuat API key type=user baru di organisasi yang terkait dengan management token saat ini.

Body Request

Bidang	Tipe	Default / Batas	Catatan
`name`	string	opsional, bawaan `Default Key`, panjang `1-50`	Nama tampilan, dipangkas di sisi server
`limitAmount`	number \| string \| null	`0–100000` USD	`null` berarti tanpa batas; `0` mencegah pengeluaran. String desimal mendukung hingga 6 angka desimal. Saat membuat kunci, menghilangkan kolom ini berarti tanpa batas.
`limitCurrency`	enum	bawaan `USD`	Hanya USD. Mengirim `CNY` menghasilkan `400 currency_retired`.
`models`	string[]	bawaan `[]`	Daftar izin model opsional
`deliveryPolicy`	string \| null	`auto`, `verified`, `official`, `null`	`null` mewarisi kebijakan pengiriman ruang kerja.
`expiresAt`	string \| null	datetime RFC3339	`null` berarti tidak kedaluwarsa

Catatan

Kolom moneter hanya mendukung USD. Input CNY telah dihentikan dan mengembalikan 400 currency_retired.
Nilai penuh API key hanya ditampilkan sekali dalam respons.
models: [] berarti key tidak memiliki batasan model tambahan di luar kebijakan organisasi.
limitAmount: 0 membuat key yang valid tetapi belum bisa memakai kuota sampai 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-3.0-video"],
    "expiresAt": "2026-12-31T23:59:59Z"
  }'

Halaman ini menyediakan skema OpenAPI dan contoh permintaan yang dapat disalin. Kirim permintaan manajemen dari terminal atau klien menggunakan 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-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
}

Kolom penting

keystring

Nilai rahasia lengkap kunci API. Nilai ini hanya dikembalikan sekali saat dibuat.

idstring

Pengidentifikasi kunci API yang digunakan dalam panggilan API Manajemen berikutnya.

namestring

Nama tampilan kunci API.

key_prefixstring

Awalan kunci nonrahasia untuk tampilan dan dukungan.

statusstring

Salah satu dari active, inactive, suspended, atau revoked.

limit_amountnumber | null

Batas pengeluaran USD sebagai angka JSON untuk tampilan. null berarti tanpa batas.

limit_amount_decimalstring | null

Batas pengeluaran USD yang tepat sebagai string desimal. null berarti tanpa batas.

used_amountnumber

Akumulasi biaya penggunaan dalam USD sebagai angka JSON untuk tampilan.

used_amount_decimalstring

Akumulasi biaya penggunaan yang tepat dalam USD sebagai string desimal.

modelsstring[]

Daftar model yang diizinkan per kunci. Array kosong berarti tidak ada batasan model tambahan di tingkat kunci.

delivery_policystring | null

auto, verified, official, null. null mewarisi kebijakan pengiriman ruang kerja.

expires_atstring | null

Stempel waktu ISO saat kunci kedaluwarsa, atau null jika tidak kedaluwarsa.

last_used_atstring | null

Stempel waktu ISO penggunaan terbaru, atau null jika belum pernah digunakan.

created_atstring

Stempel waktu ISO pembuatan.

Otorisasi

ManagementTokenAuth

AuthorizationBearer <token>

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

Lokasi: header

Body permintaan

application/json

name*string

Nama tampilan untuk kunci API pengguna. Dipotong di sisi server. Panjang harus 1-50 karakter.

Panjang1 <= length <= 50

bawaan"Default Key"

limitAmount?|

Input batas pengeluaran dalam USD. null atau dihilangkan berarti penggunaan tidak terbatas, dan 0 berarti kuota nol.

Rentang0 <= value <= 1000000

limitCurrency?"USD"

Mata uang untuk limitAmount. USD adalah satu-satunya mata uang yang aktif. Mengirim CNY akan mengembalikan 400 currency_retired.

bawaan"USD"

Nilai yang tersedia

"USD"

models?array<string>

Daftar izin model opsional. Array kosong berarti tidak ada batasan model per-kunci di luar kebijakan organisasi.

bawaan[]

expiresAt?|

Stempel waktu RFC3339 opsional. null berarti tidak ada kedaluwarsa.

Formatdate-time

deliveryPolicy?|

Kebijakan pengiriman per-kunci. null mewarisi default Workspace.

Nilai yang tersedia

"auto"
"verified"
"official"
null

Buat API Key

Ikhtisar

Body Request

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting

Otorisasi

Body permintaan

Respons

`application/json`

`application/json`

`application/json`

`application/json`

Buat API Key

IkhtisarCopy Anchor Link

Body RequestCopy Anchor Link

CatatanCopy Anchor Link

ContohCopy Anchor Link

Request / ResponsCopy Anchor Link

Contoh responsCopy Anchor Link

Kolom pentingCopy Anchor Link

OtorisasiCopy Anchor Link

Body permintaanCopy Anchor Link

ResponsCopy Anchor Link

201application/json

400application/json

401application/json

403application/json

Ikhtisar

Body Request

Catatan

Contoh

Request / Respons

Contoh respons

Kolom penting

Otorisasi

Body permintaan

Respons

`application/json`

`application/json`

`application/json`

`application/json`