Yönetim
API Anahtarı Faturalandırmasını Al
Bir kullanıcı API anahtarı için toplu faturalandırma dökümlerini döndürür.
Genel Bakış
Modele, model üreticisine, sahneye ve tarihe göre gruplandırılmış toplam harcamayı, istek sayısını, faturalandırılabilir kullanımı ve maliyeti döndürür.
Notlar
-
Parasal alanlar yalnızca USD cinsindendir.
-
Çalışma alanı (workspace) yüklemeleri ve faturalar dahil değildir.
-
Sadece tarih içeren bir
endDate, o günün başlangıcındaki 00:00 UTC saatini ifade eder. Tüm günü dahil etmek için bir sonraki tarihi veya bir RFC3339 zaman damgasını kullanın. -
report_busykoduna sahip bir429hatası, rapor kuyruğunun dolu olduğu anlamına gelir.Retry-Aftersaniye süresi geçtikten sonra tekrar deneyin.
Örnek
API anahtarı kullanımı ile aynı model, model satıcısı, sahne ve tarih filtrelerini destekler. Sayfalama olmaksızın toplamları döndürür.
İstek
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"İstek / Yanıt
Bu sayfa, OpenAPI şemasını ve kopyalanabilir istek örneklerini sağlar. Yönetim isteklerini terminalinizden veya istemcinizden bir Yönetim Token'ı (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
},
"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
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
İ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