API Manajemen

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Ikhtisar

Management API memungkinkan Anda mengambil total saldo organisasi, mengelola API key organisasi, serta mengambil usage dan billing untuk key tertentu tanpa memakai inference API key biasa. Gunakan token manajemen dari halaman Pengaturan di dasbor:

Authorization: Bearer mt-your-management-token

Management token berbeda dari inference API key. Gunakan mt-... untuk /v1/management/*, dan gunakan sk-... untuk endpoint inferensi seperti /v1/responses.

Endpoint Tersedia

Endpoint	Metode	Deskripsi
`/v1/management/balance`	GET	Ambil total saldo organisasi saat ini
`/v1/management/api-keys`	GET	Daftar API key yang dikelola user di organisasi saat ini
`/v1/management/api-keys`	POST	Buat API key user baru
`/v1/management/api-keys/{keyId}`	PATCH	Perbarui nama, batas penggunaan, model yang diizinkan, masa berlaku, atau status
`/v1/management/api-keys/{keyId}/usage`	GET	Ambil detail usage berpaginasi untuk key tertentu
`/v1/management/api-keys/{keyId}/billing`	GET	Ambil breakdown billing teragregasi untuk key tertentu

Kontrak Filter Usage

GET /v1/management/api-keys/{keyId}/usage mendukung parameter query berikut:

Parameter	Tipe	Default / Batas	Catatan
`page`	integer	bawaan `1`, minimum `1`	Nomor halaman mulai dari 1
`limit`	integer	bawaan `50`, minimum `1`, maksimum `100`	Ukuran halaman
`model`	string	panjang maks `100`	Nama model yang diminta
`modelVendor`	string	panjang maks `100`	Vendor model publik
`scene`	enum	-	`chat`, `image`, `audio`, `video`, `embedding`, `rerank`, `translation`, `music`, `3d`, `realtime`
`startDate`	string	-	Batas bawah inklusif; menerima RFC3339 dengan timezone atau `YYYY-MM-DD`
`endDate`	string	-	Batas atas inklusif; menerima RFC3339 dengan timezone atau `YYYY-MM-DD`

Jika startDate dan endDate sama-sama ada, startDate harus lebih kecil dari atau sama dengan endDate.

Kontrak Body API Key

POST /v1/management/api-keys

Bidang	Tipe	Default / Batas	Catatan
`name`	string	wajib, bawaan `Default Key`, panjang `1-50`	Nama tampilan, dipangkas di sisi server
`limitAmount`	number \| null	minimum `0`, input maksimum `1000000`	`null` atau dihilangkan = tidak terbatas, `0` = kuota nol. Nilai positif dinormalisasi menjadi batas simpan yang tidak melebihi setara `100000` USD
`limitCurrency`	enum	bawaan `USD`	Hanya USD. Mengirim `CNY` menghasilkan `400 currency_retired`.
`models`	string[]	bawaan `[]`	Daftar izin model opsional
`expiresAt`	string \| null	datetime RFC3339	`null` berarti tidak kedaluwarsa

PATCH /v1/management/api-keys/

Bidang	Tipe	Default / Batas	Catatan
`status`	enum	-	`active`, `inactive`, `revoked`
`name`	string	panjang `1-50`	Nama tampilan yang diperbarui
`limitAmount`	number \| null	minimum `0`, input maksimum `1000000`	`null` = tidak terbatas, `0` = kuota nol. Nilai positif dinormalisasi menjadi batas simpan yang tidak melebihi setara `100000` USD
`limitCurrency`	enum	bawaan `USD`	Hanya USD. Mengirim `CNY` menghasilkan `400 currency_retired`.
`models`	string[]	-	Daftar izin model yang diperbarui
`expiresAt`	string \| null	datetime RFC3339	`null` menghapus masa kedaluwarsa

Setidaknya satu field PATCH harus diberikan.

Kolom moneter

Kolom moneter dalam permintaan dan respons API Manajemen hanya mendukung USD.
limitCurrency menggunakan USD secara default; mengirim CNY akan mengembalikan 400 currency_retired.

Semantik Pelaporan

model merujuk ke model publik yang diminta caller.
modelVendor merujuk ke vendor model publik, bukan rute penyedia di balik layar.
scene adalah scene request publik yang diturunkan dari endpoint atau jenis tugas.

Respons hanya menampilkan field billing dan reporting publik. Detail routing penyedia tidak ditampilkan.

Item /usage dapat menyertakan billing_transaction_id setelah request dasar mencapai status billing yang telah diselesaikan. Gunakan request_id + billing_transaction_id untuk rekonsiliasi level request.

Catatan paginasi penagihan

/usage dipaginasi. /billing saat ini adalah endpoint breakdown teragregasi dan tidak mengembalikan metadata paginasi seperti page / limit. Jika Anda butuh record level baris, gunakan /usage.

Contoh Singkat

Mulailah dengan memeriksa saldo organisasi menggunakan management token saat ini:

curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Lalu tampilkan API key yang tersedia untuk management token yang sama:

curl "https://api.tokenlab.sh/v1/management/api-keys" \
  -H "Authorization: Bearer mt-your-management-token"

{
  "object": "list",
  "data": [
    {
      "id": "key_abc123def456",
      "name": "Backend Worker",
      "key_prefix": "sk-abc123...",
      "status": "active",
      "limit_amount": 500.0,
      "limit_amount_decimal": "500",
      "used_amount": 148.25,
      "used_amount_decimal": "148.25",
      "models": ["gpt-4o-mini", "claude-3-7-sonnet"],
      "expires_at": "2026-04-30T00:00:00.000Z",
      "last_used_at": "2026-03-27T08:12:45.000Z",
      "created_at": "2026-03-01T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "totalPages": 1
  }
}

Inti

Teks

Berkas & batch

Gambar

Audio & realtime

Musik

Video & materi

Worlds

3D

Pekerjaan asinkron

Gemini native

Manajemen

Ikhtisar

Endpoint Tersedia

Kontrak Filter Usage

Kontrak Body API Key

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Kolom moneter

Semantik Pelaporan

Catatan paginasi penagihan

Contoh Singkat

Langkah Berikutnya

​Ikhtisar

​Endpoint Tersedia

​Kontrak Filter Usage

​Kontrak Body API Key

​POST /v1/management/api-keys

​PATCH /v1/management/api-keys/

​Kolom moneter

​Semantik Pelaporan

​Catatan paginasi penagihan

​Contoh Singkat

​Langkah Berikutnya

Ikhtisar

Endpoint Tersedia

Kontrak Filter Usage

Kontrak Body API Key

POST /v1/management/api-keys

PATCH /v1/management/api-keys/

Kolom moneter

Semantik Pelaporan

Catatan paginasi penagihan

Contoh Singkat

Langkah Berikutnya