Hata Yanıt Formatı
Tüm hatalar tutarlı bir JSON formatı döndürür:HTTP Durum Kodları
| Kod | Açıklama |
|---|---|
| 400 | Bad Request - Geçersiz parametreler |
| 401 | Unauthorized - Geçersiz veya eksik API anahtarı |
| 402 | Payment Required - Yetersiz bakiye |
| 403 | Forbidden - Erişim reddedildi veya modele izin verilmiyor |
| 404 | Not Found - Model veya kaynak bulunamadı |
| 413 | Payload Too Large - Girdi veya dosya boyutu aşıldı |
| 429 | Too Many Requests - Hız sınırı aşıldı |
| 500 | Internal Server Error |
| 502 | Bad Gateway - Üst sağlayıcı hatası |
| 503 | Service Unavailable - Tüm kanallar başarısız oldu |
| 504 | Gateway Timeout - İstek zaman aşımına uğradı |
Hata Türleri
Kimlik Doğrulama Hataları (401)
| Tür | Kod | Açıklama |
|---|---|---|
invalid_api_key | invalid_api_key | API anahtarı eksik veya geçersiz |
expired_api_key | expired_api_key | API anahtarı iptal edilmiş |
Ödeme Hataları (402)
| Tür | Kod | Açıklama |
|---|---|---|
insufficient_quota | insufficient_quota | Hesap bakiyesi çok düşük |
quota_exceeded | quota_exceeded | API anahtarı kullanım sınırına ulaşıldı |
Erişim Hataları (403)
| Tür | Kod | Açıklama |
|---|---|---|
access_denied | access_denied | Kaynağa erişim reddedildi |
access_denied | model_not_allowed | Bu API anahtarı için modele izin verilmiyor |
Doğrulama Hataları (400)
| Tür | Açıklama |
|---|---|
invalid_request_error | İstek parametreleri geçersiz |
context_length_exceeded | Girdi model için çok uzun |
model_not_found | İstenen model mevcut değil |
Hız Sınırı Hataları (429)
Hız sınırlarını aştığınızda:Payload Çok Büyük (413)
Girdi veya dosya boyutu sınırları aştığında:- Resim dosyası çok büyük (maks 20MB)
- Ses dosyası çok büyük (maks 25MB)
- Girdi metni model bağlam uzunluğunu aşıyor
Üst Sunucu Hataları (502, 503)
| Tür | Açıklama |
|---|---|
upstream_error | Sağlayıcı bir hata döndürdü |
all_channels_failed | Kullanılabilir sağlayıcı yok |
timeout_error | İstek zaman aşımına uğradı |
Python’da Hataları Yönetme
JavaScript’te Hataları Yönetme
En İyi Uygulamalar
Üstel geri çekilme uygulayın
Üstel geri çekilme uygulayın
Hız sınırına takıldığınızda, denemeler arasında kademeli olarak daha uzun süre bekleyin:
Zaman aşımlarını ayarlayın
Zaman aşımlarını ayarlayın
Asılı kalan istekleri önlemek için her zaman makul zaman aşımları belirleyin:
Hata ayıklama için hataları günlüğe kaydedin
Hata ayıklama için hataları günlüğe kaydedin
Destek almak için istek kimliği (request ID) dahil olmak üzere tam hata yanıtını günlüğe kaydedin:
Modele özgü hataları yönetin
Modele özgü hataları yönetin
Bazı modellerin belirli gereksinimleri vardır (örneğin, maksimum token sayısı, resim formatları). İstek yapmadan önce girdileri doğrulayın.