# Hatalar ve kullanım sınırları

> API hata kodlarını ve kullanım sınırlarını incele. İsteğini ne zaman düzeltmen, ne zaman bekleyip yeniden göndermen gerektiğini öğren.

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

API hata yanıtlarını JSON olarak döndürür. Hatanın açıklaması `detail` alanında yer alır.

Örnek hata yanıtı:

```
{ "detail": "quote_id is required for customer generations" }
```

**HTTP durum kodları**

| Alan | Tür | Açıklama |
| --- | --- | --- |
| `400` | Bad request | Girdi geçersiz, zorunlu bir alan eksik veya girdi için ücret hesaplanamıyor. |
| `401` | Unauthorized | API anahtarı gönderilmemiş veya geçersiz. |
| `402` | Payment required | Teklifte belirtilen tutar için kullanılabilir bakiyen yetersiz. Bakiye yükledikten sonra yeniden dene. |
| `403` | Forbidden | API anahtarının bu işlem için gerekli izni yok. |
| `404` | Not found | Model veya üretim kaydı bulunamadı. Üretim kaydı başka bir hesaba ait olduğunda da bu yanıt dönebilir. |
| `409` | Conflict | Teklifin süresi dolmuş, girdi teklifle eşleşmiyor veya aynı `Idempotency-Key` farklı bir istek için kullanılmış. |
| `429` | Too many requests | Bir kullanım sınırına ulaştın. `Retry-After` başlığında belirtilen saniye kadar bekle. `X-Limit-Reason`, hangi sınıra ulaşıldığını gösterir. |
| `503` | Unavailable | API’nin bağlı olduğu bir hizmet geçici olarak kullanılamıyor. Yeniden denemeler arasında giderek daha uzun süre bekle. |

## Hesap sınırları

Kontrolsüz kullanımı önlemek için hesaplara aynı anda çalışabilecek üretim sayısı ve günlük harcama sınırı uygulanır. Daha yüksek bir sınıra ihtiyacın varsa bizimle iletişime geç.

## Kendi harcama sınırını belirle

[Harcama sınırları](https://raywake.si/alerts) sayfasından saatlik veya 24 saatlik sınır belirleyebilirsin. Bu sınırı aşacak üretim istekleri `429` yanıtıyla reddedilir.

`X-Limit-Reason: spend_limit`, isteğin harcama sınırı nedeniyle reddedildiğini belirtir. `Retry-After`, önceki harcamaların ilgili hesaplama döneminin dışında kalmasına kadar beklemen gereken saniyeyi gösterir.

Bu sınırlar stüdyodan ve tüm API anahtarlarından başlatılan üretimleri kapsar. Sınırları yalnızca stüdyodan değiştirebilirsin.

[API referansı](https://raywake.si/tr/docs/reference/models)

## İlgili

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