API hata kodları
Kimi API çağrılarında sık görülen hata kodları ve bunları çözme yolları.
Hata kodu başvurusu
| Hata Kodu | Anlamı | Çözüm |
|---|---|---|
| 400 | Hatalı İstek | İstek gövdesinin biçimini, parametre adlarını ve türlerini kontrol edin. Yaygın nedenler: hatalı biçimlendirilmiş JSON, eksik zorunlu parametreler, aralık dışı değerler. |
| 401 | Yetkisiz | API anahtarının doğru, süresinin dolmamış ve devre dışı bırakılmamış olduğundan emin olun. Header biçimini doğrulayın: Authorization: Bearer <your-api-key>. |
| 403 | Yasak (yetersiz bakiye) | Hesap bakiyesi tükendi — konsoldan bakiye yükleyin. Hesap kısıtlanmış da olabilir; gerekirse destek ekibiyle iletişime geçin. |
| 404 | Bulunamadı | İstek URL yolunu ve model adını kontrol edin. Uç noktanın https://klmi.io/v1/... olduğundan emin olun. |
| 429 | Too Many Requests | rate limit aşıldı. Sıklığı azaltın, üstel geri çekilme uygulayın veya daha yüksek limitler için destek ekibiyle iletişime geçin. |
| 500 | Internal Server Error | Geçici sunucu sorunu — daha sonra yeniden deneyin. Sorun devam ederse request_id ile birlikte [email protected] adresine başvurun. |
Genel sorun giderme ipuçları
- Tam hata mesajını kontrol edin: Yanıt JSON içinde ayrıntılı açıklama içeren
error.messagealanı bulunur. - request_id değerini not edin: Destek ekibinin sorunu hızla bulmasına yardımcı olur.
- Resmî belgelere bakın: Çağrıların platform.kimi.ai adresindeki dokümanlarla uyumlu olduğundan emin olun.
- Yeniden deneme mantığı uygulayın: 429 ve 500 hataları için üstel geri çekilme kullanın.