Manajemen
Mendapatkan Penggunaan API Key
Mengembalikan detail penggunaan yang dipaginasi untuk API key pengguna.
Ringkasan
Mengembalikan catatan penggunaan yang dipaginasi untuk satu API key.
Parameter Kueri
| Parameter | Tipe | Default / Batas | Catatan |
|---|---|---|---|
page | integer | default 1, min 1 | Nomor halaman berbasis 1 |
limit | integer | default 50, min 1, max 100 | Ukuran halaman |
model | string | max length 100 | Nama model yang diminta |
modelVendor | string | max length 100 | Vendor model publik |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | Batas bawah inklusif; menerima RFC3339 dengan zona waktu atau YYYY-MM-DD (00:00 UTC) |
endDate | string | - | Batas atas inklusif; menerima RFC3339 dengan zona waktu atau YYYY-MM-DD. Nilai tanggal saja berarti 00:00 UTC di awal hari tersebut, jadi untuk menyertakan satu hari penuh gunakan tanggal berikutnya atau waktu RFC3339 |
Jika startDate dan endDate keduanya ada, startDate harus lebih awal dari atau sama dengan endDate.
Catatan
-
Bidang moneter hanya dalam USD.
-
Respons dipaginasi.
-
Catatan yang telah diselesaikan dapat menyertakan
billing_transaction_id. Simpan ID tersebut bersamarequest_idsaat Anda perlu mencocokkan tagihan dengan permintaan. -
Catatan diurutkan berdasarkan
created_at, yang terbaru terlebih dahulu. -
Kode
429dengan kodereport_busyberarti antrean laporan penuh. Coba lagi setelah detik yang ditentukan dalamRetry-After.
Permintaan
curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=chat&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
},
"items": [
{
"request_id": "req_abc123",
"billing_transaction_id": "billtxn_abc123",
"model": "gpt-5.6-luna",
"logical_model": "gpt-5.6-luna",
"model_vendor": "OpenAI",
"scene": "chat",
"usage_unit": "per_token",
"usage_quantity": 1500,
"usage_quantity_decimal": "1500",
"prompt_tokens": 1000,
"completion_tokens": 500,
"total_tokens": 1500,
"cache_read_tokens": 0,
"cache_write_tokens": 0,
"cache_write_tokens_5m": 0,
"cache_write_tokens_1h": 0,
"cost": 0.0012,
"cost_decimal": "0.0012",
"created_at": "2026-07-08T03:15:00.000Z",
"requested_policy": null,
"resolved_tier": null,
"charged_price_basis": null
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 1,
"totalPages": 1
},
"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
page, limit, total, dan totalPages.per_token.auto, verified, official, null. Kebijakan pengiriman yang diminta, saat dicatat.verified, official, null. Tingkat pengiriman yang digunakan, saat dicatat.measure.dimensions mencakup webSearchCalls atau groundedPrompts, dan effectiveUnitPrices mencakup harga setiap panggilan sebagai webSearch atau groundedPrompt.Otorisasi
ManagementTokenAuth Autentikasi token manajemen. Buat atau kelola Management Token di Dashboard > API > Management Tokens.
Lokasi: header
Parameter path
Parameter query
Nomor halaman berbasis 1. Default adalah 1.
1 <= value1Ukuran halaman. Default adalah 50 dan maksimum adalah 100.
1 <= value <= 10050Filter 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