Usage API
Kullanım istatistikleri ve logları
/v1/usage
API kullanım loglarını döndürür.
Query Parametreleri
Sayfa başına kayıt. Varsayılan: 20, en çok 100.
Sayfa numarası (1'den başlar). Varsayılan: 1
per_page ile aynı (takma ad).
Atlanacak kayıt sayısı; page verilmediyse kullanılır. Varsayılan: 0
Bu tarihten (dahil, TSİ 00:00) itibaren kayıtlar.
Bu tarihe kadar (dahil, TSİ 23:59) kayıtlar.
Yalnız bu model kimliğinin kayıtları (örn. openai/text-embedding-3-small).
Yalnız bu durumdaki kayıtlar: success, error ya da timeout.
Yanıt {"success": true, "data": [...], "pagination": {"total", "per_page", "current_page", "total_pages", "has_more"}} biçimindedir; en yeni kayıt önce gelir. Kayıt başına cost (USD, 6 hane) ve cost_tl (bakiyeden düşen TL) bulunur.
Kullanım Özeti
/v1/usage/summary
Toplam kullanım istatistiklerini döndürür. Dönem: ?period=7d, 30d (varsayılan), 90d ya da all.
{
"success": true,
"data": {
"period": "30d",
"total_requests": 1250,
"successful_requests": 1230,
"failed_requests": 20,
"total_tokens": {
"input": 312000,
"output": 146000,
"total": 458000
},
"total_cost": 45.800000,
"average_response_time_ms": 1250.45,
"currency": "USD"
}
}
Model Bazlı Kullanım
/v1/usage/models
Model bazlı kullanım istatistiklerini döndürür.
Diğer Kullanım Uçları
/v1/usage/{request_id}
Tek bir isteğin kullanım kaydını döndürür (request_id = yanıttaki id; Responses yanıtlarında resp_<kimlik> yerine req_<kimlik>).
/v1/usage/daily
Günlük kullanım istatistiklerini döndürür.
/v1/usage/hourly
Son 24 saatin saatlik kullanım istatistiklerini döndürür.
/v1/usage/rate-limit
Dakikalık ve günlük istek sınırı durumunuzu döndürür (bkz. Rate Limits).