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.

GEThttps://api.tokenlab.sh/v1/management/api-keys/{keyId}/usage

Genel Bakış

Bir API anahtarı için sayfalandırılmış kullanım kayıtlarını döndürür.

Sorgu Parametreleri

ParametreTipVarsayılan / SınırlarNotlar
pageintegervarsayılan 1, min 11 tabanlı sayfa numarası
limitintegervarsayılan 50, min 1, max 100Sayfa boyutu
modelstringmax uzunluk 100İstenen model adı
modelVendorstringmax uzunluk 100Genel model sağlayıcısı
sceneenum-chat, image, audio, video, embedding, rerank, translation, music, 3d, realtime, systemone
startDatestring-Kapsayıcı alt sınır; zaman dilimi içeren RFC3339 veya YYYY-MM-DD (00:00 UTC) kabul eder
endDatestring-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_id içerebilir. Bir ücreti bir istekle eşleştirmeniz gerektiğinde bunu request_id ile birlikte kaydedin.

  • Kayıtlar created_at değerine göre, en yenisi ilk sırada olacak şekilde sıralanır.

  • report_busy koduna sahip bir 429 hatası, rapor kuyruğunun dolu olduğu anlamına gelir. Retry-After saniye süresi geçtikten sonra tekrar deneyin.

Örnek

İstek

cURL
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 örneği

Yanıt

200 OK
{
  "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

api_keyobject
Liste/oluşturma/güncelleme yanıtlarıyla aynı alanları kullanan API anahtarı özeti.
itemsarray
Sayfalandırılmış kullanım satırları.
paginationobject
page, limit, total ve totalPages içeren sayfalandırma meta verileri.
summaryobject
Seçilen filtreler için toplanmış toplamlar.
breakdownsobject
Seçilen filtreler için toplanmış dökümler.
items[].request_idstring | null
Destek ve mutabakat için genel istek tanımlayıcısı.
items[].billing_transaction_idstring | null
Mevcut olduğunda tamamlanmış faturalandırma işlem kimliği.
items[].modelstring
İstenen genel model adı.
items[].logical_modelstring
Raporlama için kullanılan mantıksal genel model.
items[].model_vendorstring | null
Genel model sağlayıcısı.
items[].scenestring | null
Genel istek sahnesi.
items[].usage_unitstring
per_token gibi faturalandırma kullanım birimi.
items[].usage_quantitynumber
Görüntüleme için JSON sayısı olarak kullanım miktarı.
items[].usage_quantity_decimalstring
Ondalık dize olarak tam kullanım miktarı.
items[].prompt_tokensnumber
İstem (prompt) token sayısı.
items[].completion_tokensnumber
Tamamlama (completion) token sayısı.
items[].total_tokensnumber
Toplam token sayısı.
items[].cache_read_tokensnumber
Önbellek okuma token sayısı.
items[].cache_write_tokensnumber
Toplam önbellek yazma token sayısı.
items[].cache_write_tokens_5mnumber
Beş dakikalık önbellek yazma token sayısı.
items[].cache_write_tokens_1hnumber
Bir saatlik önbellek yazma token sayısı.
items[].costnumber
Görüntüleme için JSON sayısı olarak USD cinsinden maliyet.
items[].cost_decimalstring
Ondalık dize olarak USD cinsinden tam maliyet.
items[].requested_policystring | null
auto, verified, official, null. Kaydedildiğinde istenen teslimat politikası.
items[].resolved_tierstring | null
verified, official, null. Kaydedildiğinde kullanılan teslimat katmanı.
items[].charged_price_basisobject | null
Kaydedildiğinde uygulanan fiyat ve faturalandırılabilir miktar. Araç ücretleri içeren bir istek için measure.dimensions, webSearchCalls veya groundedPrompts içerir ve effectiveUnitPrices, her bir çağrının fiyatını webSearch veya groundedPrompt olarak içerir.
items[].created_atstring
ISO kullanım satırı zaman damgası.
summary.total_requestsnumber
Toplam istek sayısı.
summary.total_costnumber
Görüntüleme için JSON sayısı olarak USD cinsinden toplam maliyet.
summary.total_cost_decimalstring
Ondalık dize olarak USD cinsinden tam toplam maliyet.
summary.total_prompt_tokensnumber
Toplam istem tokenları.
summary.total_completion_tokensnumber
Toplam tamamlama tokenları.
summary.total_tokensnumber
Toplam tokenlar.
summary.usage_unit_breakdownarray
Kullanım birimine göre gruplandırılmış kullanım miktarı.
breakdowns.by_modelarray
İstenen genel modele göre döküm.
breakdowns.by_logical_modelarray
Mantıksal genel modele göre döküm.
breakdowns.by_model_vendorarray
Genel model sağlayıcısına göre döküm.
breakdowns.by_scenearray
Genel istek sahnesine göre döküm.
breakdowns.daily_costarray
Günlük maliyet eğilimi.

Yetkilendirme

ManagementTokenAuth
AuthorizationBearer <token>

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

keyId*string

Sorgu parametreleri

page?integer

1'den başlayan sayfa numarası. Varsayılan 1'dir.

Aralık1 <= value
varsayılan1
limit?integer

Sayfa boyutu. Varsayılan 50, maksimum 100'dür.

Aralık1 <= value <= 100
varsayılan50
model?string

İstenen model adına göre filtrele. Maksimum uzunluk 100.

Uzunluklength <= 100
modelVendor?string

Genel model sağlayıcısına göre filtrele. Maksimum uzunluk 100.

Uzunluklength <= 100
scene?string

Genel istek sahnesine göre filtrele.

Geçerli değerler

  • "chat"
  • "image"
  • "audio"
  • "video"
  • "embedding"
  • "rerank"
  • "translation"
  • "music"
  • "3d"
  • "realtime"
  • "systemone"
startDate?string

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.

endDate?string

Ü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