Manajemen
Mendapatkan Penagihan API Key
Mengembalikan rincian penagihan agregat untuk API key pengguna.
Gambaran Umum
Mengembalikan total pengeluaran, jumlah permintaan, penggunaan yang dapat ditagih, dan biaya yang dikelompokkan berdasarkan model, pembuat model, scene, dan tanggal.
Catatan
-
Bidang moneter hanya dalam USD.
-
Top-up ruang kerja dan faktur tidak disertakan.
-
endDateyang hanya berupa tanggal berarti pukul 00:00 UTC pada awal hari tersebut. Untuk menyertakan satu hari penuh, gunakan tanggal berikutnya atau waktu RFC3339. -
429dengan kodereport_busyberarti antrean laporan penuh. Coba lagi setelah detik yang ditentukan dalamRetry-After.
Contoh
Mendukung filter model, vendor model, scene, dan tanggal yang sama seperti penggunaan API key. Mengembalikan total tanpa penomoran halaman (pagination).
Permintaan
curl -X GET "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/billing?startDate=2026-07-01&endDate=2026-07-31T23:59:59Z" \
-H "Authorization: Bearer mt-your-management-token"Permintaan / Respons
Halaman ini menyediakan skema OpenAPI dan contoh permintaan yang dapat disalin. Kirim permintaan manajemen dari terminal atau klien Anda dengan Management Token; pengiriman langsung tidak tersedia di halaman ini.
Respons
{
"api_key": {
"id": "key_abc123def456",
"name": "Backend Worker",
"key_prefix": "sk-live...",
"status": "active",
"limit_amount": 500,
"limit_amount_decimal": "500",
"used_amount": 148.25,
"used_amount_decimal": "148.25",
"models": [
"gpt-5.6-luna",
"claude-sonnet-4-6"
],
"expires_at": "2026-12-31T23:59:59.000Z",
"last_used_at": "2026-07-08T03:12:45.000Z",
"created_at": "2026-07-01T10:00:00.000Z",
"delivery_policy": null
},
"summary": {
"total_requests": 1,
"total_cost": 0.0012,
"total_cost_decimal": "0.0012",
"total_prompt_tokens": 1000,
"total_completion_tokens": 500,
"total_tokens": 1500,
"usage_unit_breakdown": [
{
"usage_unit": "per_token",
"usage_quantity": 1500
}
]
},
"breakdowns": {
"by_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_logical_model": [
{
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500"
}
],
"by_model_vendor": [
{
"model_vendor": "OpenAI",
"requests": 1,
"cost": 0.0012
}
],
"by_scene": [
{
"scene": "chat",
"requests": 1,
"cost": 0.0012,
"cost_decimal": "0.0012"
}
],
"daily_cost": [
{
"date": "2026-07-08T00:00:00.000Z",
"cost": 0.0012,
"cost_decimal": "0.0012"
}
]
}
}Bidang penting
Otorisasi
ManagementTokenAuth Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.
Lokasi: header
Parameter path
Parameter query
Filter berdasarkan nama model yang diminta. Panjang maksimum 100.
length <= 100Filter berdasarkan vendor model publik. Panjang maksimum 100.
length <= 100Filter berdasarkan skenario permintaan publik.
Nilai yang tersedia
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
Batas bawah, inklusif. Menerima RFC3339 dengan zona waktu (misalnya 2026-03-28T00:00:00+08:00) atau YYYY-MM-DD, yang berarti 00:00 UTC.
Batas atas, inklusif. Menerima RFC3339 dengan zona waktu (misalnya 2026-03-28T23:59:59+08:00) atau YYYY-MM-DD, yang berarti 00:00 UTC pada awal hari tersebut. Untuk menyertakan satu hari penuh, masukkan tanggal hari berikutnya atau waktu RFC3339 di akhir hari.
Respons
application/json
application/json
application/json
application/json
application/json
application/json