Hata Kodları

API hata yanıtları ve çözümleri

Onysoft API, standart HTTP durum kodları ve detaylı hata mesajları döndürür.

HTTP Durum Kodları

Kod	Anlam	Açıklama
`200`	OK	İstek başarıyla tamamlandı
`202`	Accepted	Asenkron görev oluşturuldu (video/görsel/müzik)
`400`	Bad Request	Geçersiz istek formatı veya eksik parametre
`401`	Unauthorized	Geçersiz veya eksik API anahtarı
`402`	Payment Required	Yetersiz bakiye
`403`	Forbidden	Proje askıda, model engellenmiş veya erişim reddedildi
`404`	Not Found	Model bulunamadı veya endpoint yanlış
`413`	Payload Too Large	İstek boyutu çok büyük (max 10MB — base64 görsel için)
`422`	Unprocessable Entity	Model desteklenmiyor (KieAI tarafı)
`429`	Too Many Requests	Rate limit veya token limit aşıldı
`500`	Internal Server Error	Sunucu hatası

Hata Yanıt Formatı

                JSON
            

{
  "success": false,
  "error": {
    "code": "insufficient_balance",
    "message": "Yetersiz bakiye. Lütfen bakiye yükleyin."
  }
}
            

Yaygın Hatalar ve Çözümleri

invalid_api_key

API anahtarınız geçersiz veya deaktif edilmiş. Dashboard'dan yeni bir anahtar oluşturun.

insufficient_balance

Bakiyeniz bu işlem için yetersiz. Dashboard'dan bakiye yükleyin.

model_not_found

Belirtilen model bulunamadı. Model ID'sinin doğru olduğundan emin olun.

rate_limit_exceeded

Dakikalık istek limitini aştınız. Biraz bekleyip tekrar deneyin.

daily_token_limit_exceeded

Bu model için tanımlanan günlük token limitine ulaştınız. Yeni limitinizi yoneticinize (partner) danışın veya günlük sıfırlanmayı bekleyin.

monthly_token_limit_exceeded

Bu model için tanımlanan aylık token limitine ulaştınız. Ayın ilk günü sıfırlanır.

daily_request_limit_exceeded

Bu model için tanımlanan günlük istek sayısı limitine ulaştınız.

model_blocked

Bu model, proje/müşteri için engellenmiş. Erişim için partner veya admin ile iletişime geçin.

free_model_rate_limit

Ücretsiz model kullanım limitini aştınız. 24 saat içinde en fazla 5 istek gönderilebilir.

payload_too_large

İstek boyutu çok büyük. Base64 görsel yüklüyorsanız, görseli küçültün (max 10 MB) veya doğrudan public URL ile gönderin.

generation_failed

Video/görsel/müzik üretimi başarısız oldu. Genellikle KieAI tarafında geçici bir sorundur — başka bir model deneyin veya birkaç dakika sonra tekrar deneyin.

unsupported_model

Model DB'de bulunamadı veya is_active = 0. Güncel model listesi için GET /v1/models çağırın.