Yönetim
API Anahtarı Kullanımını Al
Bir kullanıcı API anahtarı için sayfalandırılmış kullanım detaylarını döndürür.
Genel Bakış
Bir API anahtarı için sayfalandırılmış kullanım kayıtlarını döndürür.
Sorgu Parametreleri
| Parametre | Tip | Varsayılan / Sınırlar | Notlar |
|---|---|---|---|
page | integer | varsayılan 1, min 1 | 1 tabanlı sayfa numarası |
limit | integer | varsayılan 50, min 1, max 100 | Sayfa boyutu |
model | string | max uzunluk 100 | İstenen model adı |
modelVendor | string | max uzunluk 100 | Genel model sağlayıcısı |
scene | enum | - | chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone |
startDate | string | - | Kapsayıcı alt sınır; zaman dilimi içeren RFC3339 veya YYYY-MM-DD (00:00 UTC) kabul eder |
endDate | string | - | Kapsayıcı üst sınır; zaman dilimi içeren RFC3339 veya YYYY-MM-DD kabul eder. Sadece tarih içeren değer, o günün başlangıcındaki 00:00 UTC anlamına gelir, bu nedenle tüm günü dahil etmek için bir sonraki tarihi veya bir RFC3339 zaman damgasını kullanın |
Hem startDate hem de endDate mevcutsa, startDate değeri endDate değerinden küçük veya ona eşit olmalıdır.
Notlar
-
Parasal alanlar yalnızca USD cinsindendir.
-
Yanıt sayfalandırılmıştır.
-
Tamamlanmış kayıtlar
billing_transaction_idiçerebilir. Bir ücreti bir istekle eşleştirmeniz gerektiğinde bunurequest_idile birlikte kaydedin. -
Kayıtlar
created_atdeğerine göre, en yenisi ilk sırada olacak şekilde sıralanır. -
report_busykoduna sahip bir429hatası, rapor kuyruğunun dolu olduğu anlamına gelir.Retry-Aftersaniye süresi geçtikten sonra tekrar deneyin.
İstek
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"İstek / Yanıt
Bu sayfa, OpenAPI şemasını ve kopyalanabilir istek örneklerini sağlar. Yönetim isteklerini terminalinizden veya istemcinizden bir Management Token ile gönderin; bu sayfadan doğrudan gönderim yapılamaz.
Yanıt
{
"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"
}
]
}
}Önemli alanlar
page, limit, total ve totalPages içeren sayfalandırma meta verileri.per_token gibi faturalandırma kullanım birimi.auto, verified, official, null. Kaydedildiğinde istenen teslimat politikası.verified, official, null. Kaydedildiğinde kullanılan teslimat katmanı.measure.dimensions, webSearchCalls veya groundedPrompts içerir ve effectiveUnitPrices, her bir çağrının fiyatını webSearch veya groundedPrompt olarak içerir.Yetkilendirme
ManagementTokenAuth Yönetim belirteci kimlik doğrulaması. Yönetim Belirteçlerini Dashboard > API > Management Tokens bölümünden oluşturun veya yönetin.
Konum: header
Yol parametreleri
Sorgu parametreleri
1'den başlayan sayfa numarası. Varsayılan 1'dir.
1 <= value1Sayfa boyutu. Varsayılan 50, maksimum 100'dür.
1 <= value <= 10050İstenen model adına göre filtrele. Maksimum uzunluk 100.
length <= 100Genel model sağlayıcısına göre filtrele. Maksimum uzunluk 100.
length <= 100Genel istek sahnesine göre filtrele.
Geçerli değerler
- "chat"
- "image"
- "audio"
- "video"
- "embedding"
- "rerank"
- "translation"
- "music"
- "3d"
- "realtime"
- "systemone"
Alt sınır, dahil. Zaman dilimi ile birlikte RFC3339 (örneğin 2026-03-28T00:00:00+08:00) veya 00:00 UTC anlamına gelen YYYY-MM-DD formatını kabul eder.
Üst sınır, dahil. Zaman dilimi ile birlikte RFC3339 (örneğin 2026-03-28T23:59:59+08:00) veya o günün başlangıcında 00:00 UTC anlamına gelen YYYY-MM-DD formatını kabul eder. Tüm günü dahil etmek için bir sonraki günün tarihini veya gün sonundaki bir RFC3339 zamanını geçin.
Yanıt
application/json
application/json
application/json
application/json
application/json
application/json