Manajemen

API Manajemen

Periksa saldo Workspace, kelola API key, dan dapatkan data penggunaan serta penagihan

Gunakan Management API dari backend atau otomasi Anda sendiri untuk mengelola Workspace TokenLab. API ini menggunakan token manajemen, sehingga program tidak memerlukan API key reguler.

Buat token manajemen di Dashboard → API → Management Tokens:

Authorization: Bearer mt-your-management-token

Token manajemen dan API key memiliki peran yang berbeda. Gunakan mt-... hanya dengan /v1/management/*. Gunakan sk-... dengan API model seperti /v1/responses.

Endpoint

EndpointMetodePenggunaan
/v1/management/balanceGETDapatkan saldo Workspace
/v1/management/api-keysGETDaftar API key
/v1/management/api-keysPOSTBuat API key
/v1/management/api-keys/{keyId}PATCHUbah nama, limit, model, masa kedaluwarsa, atau statusnya
/v1/management/api-keys/{keyId}/usageGETDapatkan rekaman penggunaan individual
/v1/management/api-keys/{keyId}/billingGETDapatkan ringkasan penagihan

API Key

  • Secret lengkap dari key baru hanya muncul pada respons pembuatan.
  • models: [] tidak menambahkan pembatasan model di tingkat key.
  • limitAmount: null berarti tidak terbatas. 0 mencegah key menghasilkan biaya pengeluaran.
  • Jumlah menggunakan USD. Mengirimkan CNY mengembalikan 400 currency_retired.
  • inactive dapat diaktifkan kembali. Gunakan revoked untuk menonaktifkan key secara permanen.

Penggunaan dan Penagihan

/usage mengembalikan rekaman terpaginasi dan mendukung filter model, pembuat model, scene, serta tanggal. Rekaman yang telah diselesaikan dapat mencakup billing_transaction_id; simpan bersama dengan request_id saat Anda perlu mencocokkan biaya dengan suatu permintaan.

/billing mengembalikan total yang dikelompokkan berdasarkan model, pembuat model, scene, dan tanggal. Ini tidak mencakup top-up Workspace atau faktur.

endDate yang hanya berupa tanggal seperti 2026-07-31 berarti 00:00 UTC pada awal hari tersebut. Untuk menyertakan seluruh hari, teruskan tanggal berikutnya atau waktu RFC3339 seperti 2026-07-31T23:59:59Z.

Error

Error menggunakan objek error standar. Tangani berdasarkan status dan code.

StatuscodeArti
400validation_errorField atau parameter kueri tidak valid
400invalid_model_accessModel dalam models tidak diizinkan oleh kebijakan model Workspace
400currency_retiredlimitCurrency adalah CNY; gunakan USD
401invalid_management_tokenToken hilang, format salah, atau telah dicabut
403organization_inactiveWorkspace tidak aktif
404not_foundAPI key tidak ada di Workspace ini
409api_key_revokedKey yang telah dicabut tidak dapat diaktifkan kembali; buat key baru
429report_busyTerlalu banyak laporan penggunaan atau penagihan yang sedang berjalan. Coba lagi setelah detik pada Retry-After

Contoh

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

Selanjutnya

Di halaman ini