Usage API

Kullanım istatistikleri ve logları

GET /v1/usage

API kullanım loglarını döndürür.

Query Parametreleri

per_page integer opsiyonel

Sayfa başına kayıt. Varsayılan: 20, en çok 100.

page integer opsiyonel

Sayfa numarası (1'den başlar). Varsayılan: 1

limit integer opsiyonel

per_page ile aynı (takma ad).

offset integer opsiyonel

Atlanacak kayıt sayısı; page verilmediyse kullanılır. Varsayılan: 0

start_date string (YYYY-MM-DD) opsiyonel

Bu tarihten (dahil, TSİ 00:00) itibaren kayıtlar.

end_date string (YYYY-MM-DD) opsiyonel

Bu tarihe kadar (dahil, TSİ 23:59) kayıtlar.

model string opsiyonel

Yalnız bu model kimliğinin kayıtları (örn. openai/text-embedding-3-small).

status string opsiyonel

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

GET /v1/usage/summary

Toplam kullanım istatistiklerini döndürür. Dönem: ?period=7d, 30d (varsayılan), 90d ya da all.

JSON Response
{
  "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

GET /v1/usage/models

Model bazlı kullanım istatistiklerini döndürür.

Diğer Kullanım Uçları

GET /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>).

GET /v1/usage/daily

Günlük kullanım istatistiklerini döndürür.

GET /v1/usage/hourly

Son 24 saatin saatlik kullanım istatistiklerini döndürür.

GET /v1/usage/rate-limit

Dakikalık ve günlük istek sınırı durumunuzu döndürür (bkz. Rate Limits).

Size uygun modeli bulmanıza yardımcı olayım mı?