API hata kodları
Kimi API çağrılırken karşılaşılan yaygın hata kodları ve bunların nasıl çözüleceği.
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: bozuk JSON, eksik zorunlu parametreler, aralık dışı değerler. |
| 401 | Yetkisiz | API Anahtarının doğru, süresi dolmamış ve etkin olduğunu doğrulayın. Başlık biçimini onaylayı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://api.moonshot.ai/v1/... olduğunu onaylayın. |
| 429 | Çok Fazla İstek | 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 | Sunucu İç Hatası | Geçici sunucu sorunu — daha sonra tekrar deneyin. Sorun devam ederse request_id ile birlikte [email protected] adresine yazın. |
Genel sorun giderme ipuçları
- Tam hata mesajını kontrol edin: Yanıt JSON'u, ayrıntılı açıklama içeren
error.messagealanını barındırır. - request_id'yi not edin: Destek ekibinin sorunu hızla bulmasına yardımcı olur.
- Resmi belgelere başvurun: Çağrılarınızın platform.kimi.ai adresindeki belgelerle uyumlu olduğundan emin olun.
- Yeniden deneme mantığı uygulayın: 429 ve 500 hataları için üstel geri çekilme kullanın.