# Kullanım istatistikleri

> Bakiye harcamalarını ve üretim sayılarını dönem, gün ve model bazında incele. Başarısız üretimlerin nedenlerini gör.

Canonical: https://raywake.si/tr/docs/reference/usage
Last updated: 2026-10-13

`GET /v1/usage`

Bakiye harcamalarını, üretim sayılarını ve sonuçlarını UTC gününe ve modele göre döndürür. Harcama tutarından kullanıma bağlı bakiye iadeleri düşülmüştür. Yanıtta başarısızlık nedenleri de yer alır. `jobs:read` izni gerekir.

**Sorgu parametreleri**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `days` | integer | Bugünü kapsayan ve bugün sona eren dönemin gün sayısı. Varsayılan: `30`. Seçenekler: `7`, `30`, `90`. |

**Example**

cURL:

```bash
curl -s https://api.raywake.com/v1/usage?days=7 \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"
```

Python:

```python
import json, os, requests

response = requests.get(
    "https://api.raywake.com/v1/usage?days=7",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"},
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/usage?days=7", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}` },
});
console.log(await response.json());
```

**Yanıt alanları**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `totals` | object | Dönem toplamları: harcanan bakiye (`spent`), eklenen bakiye (`added`), üretimler (`runs`), başarılı üretimler (`succeeded`), başarısız üretimler (`failed`) ve inceleme bekleyen üretimler (`held`). |
| `daily` | array | Her gün için bir kayıt: tarih (`date`), harcanan bakiye (`spent`), üretim sayısı (`runs`) ve başarısız üretim sayısı (`failed`). |
| `models` | array | Model kimliği bazında `runs`, `succeeded`, `failed` ve `spent` değerleri. En çok bakiye harcanan model ilk sırada yer alır. |
| `failures` | array | İçeriğin veya girdinin reddedilmesi gibi başarısızlık nedenleri ve her birinin kaç kez gerçekleştiği. |

## İlgili

- [API dokümantasyonu](https://raywake.si/tr/docs)
