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-tokenToken manajemen dan API key memiliki peran yang berbeda. Gunakan mt-... hanya dengan /v1/management/*. Gunakan sk-... dengan API model seperti /v1/responses.
Endpoint
| Endpoint | Metode | Penggunaan |
|---|---|---|
/v1/management/balance | GET | Dapatkan saldo Workspace |
/v1/management/api-keys | GET | Daftar API key |
/v1/management/api-keys | POST | Buat API key |
/v1/management/api-keys/{keyId} | PATCH | Ubah nama, limit, model, masa kedaluwarsa, atau statusnya |
/v1/management/api-keys/{keyId}/usage | GET | Dapatkan rekaman penggunaan individual |
/v1/management/api-keys/{keyId}/billing | GET | Dapatkan ringkasan penagihan |
API Key
- Secret lengkap dari key baru hanya muncul pada respons pembuatan.
models: []tidak menambahkan pembatasan model di tingkat key.limitAmount: nullberarti tidak terbatas.0mencegah key menghasilkan biaya pengeluaran.- Jumlah menggunakan USD. Mengirimkan
CNYmengembalikan400 currency_retired. inactivedapat diaktifkan kembali. Gunakanrevokeduntuk 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.
| Status | code | Arti |
|---|---|---|
| 400 | validation_error | Field atau parameter kueri tidak valid |
| 400 | invalid_model_access | Model dalam models tidak diizinkan oleh kebijakan model Workspace |
| 400 | currency_retired | limitCurrency adalah CNY; gunakan USD |
| 401 | invalid_management_token | Token hilang, format salah, atau telah dicabut |
| 403 | organization_inactive | Workspace tidak aktif |
| 404 | not_found | API key tidak ada di Workspace ini |
| 409 | api_key_revoked | Key yang telah dicabut tidak dapat diaktifkan kembali; buat key baru |
| 429 | report_busy | Terlalu 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"