Gemini API'yi çağırırken ortaya çıkan yaygın sorunları teşhis edip çözmenize yardımcı olması için bu kılavuzu kullanın. Gemini API arka uç hizmetinden veya istemci SDK'larından kaynaklanan sorunlarla karşılaşabilirsiniz. İstemci SDK'larımız aşağıdaki depolarda açık kaynak olarak mevcuttur:
API anahtarı sorunlarıyla karşılaşırsanız API anahtarınızı API anahtarı kurulum kılavuzuna göre doğru şekilde oluşturduğunuzdan emin olun.
Gemini API arka uç hizmeti hata kodları
Aşağıdaki tabloda, karşılaşabileceğiniz yaygın arka uç hata kodları, bunların nedenleri ve sorun giderme adımları listelenmiştir:
| HTTP Kodu | Durum | Açıklama | Örnek | Çözüm |
| 400 | INVALID_ARGUMENT | İstek metni bozuk. | İsteğinizde yazım hatası veya zorunlu bir alan eksik. | İstek biçimi, örnekler ve desteklenen sürümler için API referansını inceleyin. Daha yeni bir API sürümünün özelliklerini eski bir uç noktayla kullanmak hatalara neden olabilir. |
| 400 | FAILED_PRECONDITION | Gemini API'nin ücretsiz katmanı ülkenizde kullanılamıyor. Lütfen Google AI Studio'da projenizde faturalandırmayı etkinleştirin. | Ücretsiz katmanın desteklenmediği bir bölgeden istekte bulunuyorsanız ve Google AI Studio'da projenizde faturalandırmayı etkinleştirmediyseniz. | Gemini API'yi kullanmak için Google AI Studio'yu kullanarak ücretli bir plan oluşturmanız gerekir. |
| 403 | PERMISSION_DENIED | API anahtarınız gerekli izinlere sahip değil. | Yanlış API anahtarı kullanıyorsanız; doğru kimlik doğrulamasını tamamlamadan ayarlanmış bir modeli kullanmaya çalışıyorsanız. | API anahtarınızın ayarlandığından ve doğru erişime sahip olduğundan emin olun. Ayrıca, ayarlanmış modelleri kullanmak için uygun kimlik doğrulamasını yaptığınızdan emin olun. |
| 404 | NOT_FOUND | İstenen kaynak bulunamadı. | İsteğinizde referans verilen resim, ses veya video dosyası bulunamadı. | API sürümünüz için isteğinizdeki tüm parametrelerin geçerli olup olmadığını kontrol edin. |
| 429 | RESOURCE_EXHAUSTED | Oran sınırını aştınız. | Ücretsiz katman Gemini API'yi kullanarak dakika başına çok fazla istek gönderiyorsunuz. | Modelin oran sınırını aşmadığınızdan emin olun. Gerekirse kota artışı isteğinde bulunun. |
| 500 | DAHİLİ | Google tarafında beklenmeyen bir hata oluştu. | Giriş bağlamınız çok uzun. | Giriş bağlamınızı azaltın veya geçici olarak başka bir modele geçin (ör. Gemini 1.5 Pro'dan Gemini 1.5 Flash'a) ve sorunun çözülüp çözülmediğine bakın. Dilerseniz biraz bekleyip isteğinizi tekrar deneyebilirsiniz. Yeniden denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak sorunu bildirin. |
| 503 | UNAVAILABLE | Hizmet geçici olarak aşırı yüklü veya kapalı olabilir. | Hizmetin geçici olarak kapasitesi tükeniyor. | Geçici olarak başka bir modele geçin (ör. Gemini 1.5 Pro'dan Gemini 1.5 Flash'a) ve sorunun çözülüp çözülmediğine bakın. Dilerseniz biraz bekleyip isteğinizi tekrar deneyebilirsiniz. Yeniden denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak sorunu bildirin. |
| 504 | DEADLINE_EXCEEDED | Hizmet, işleme işlemini son tarihe kadar tamamlayamıyor. | İsteminiz (veya bağlamınız) zamanında işlenemeyecek kadar büyük. | Bu hatayı önlemek için istemci isteğinizde daha uzun bir "zaman aşımı" ayarlayın. |
İstemci SDK'sı hata kodları
API çağrılarınızda model parametresi hatalarını kontrol etme
Model parametrelerinizin aşağıdaki değerler arasında olduğundan emin olun:
| Model parametresi | Değerler (aralık) |
| Aday sayısı | 1-8 (tam sayı) |
| Sıcaklık | 0,0-1,0 |
| Maksimum çıkış jetonu |
Kullandığınız modelin maksimum jeton sayısını belirlemek için get_model (Python) işlevini kullanın.
|
| TopP | 0,0-1,0 |
Parametre değerlerini kontrol etmenin yanı sıra doğru API sürümünü (ör. /v1 veya /v1beta) ve ihtiyacınız olan özellikleri destekleyen bir model seçin. Örneğin, Beta sürümündeki bir özellik yalnızca /v1beta API sürümünde kullanılabilir.
Doğru modele sahip olup olmadığınızı kontrol edin
Modeller sayfamızda listelenen desteklenen bir model kullandığınızdan emin olun.
Güvenlik sorunları
API çağrınızdaki bir güvenlik ayarı nedeniyle istem engellendiğini görürseniz istemi, API çağrısında ayarladığınız filtrelerle ilgili olarak inceleyin.
BlockedReason.OTHER görürseniz sorgu veya yanıt hizmet şartlarını ihlal ediyor veya başka bir şekilde desteklenmiyor olabilir.
Ezber sorunu
Modelin, RECITATION nedeniyle çıkış üretmeyi durdurduğunu görürseniz bu, model çıkışının belirli verilere benzeyebileceği anlamına gelir. Bu sorunu düzeltmek için istemi / bağlamı mümkün olduğunca benzersiz hale getirmeyi ve daha yüksek bir sıcaklık kullanmayı deneyin.
Model çıkışını iyileştirme
Daha yüksek kaliteli model çıkışları için daha yapılandırılmış istemler yazmaya çalışın. İstem tasarımına giriş sayfasında, başlangıç için bazı temel kavramlar, stratejiler ve en iyi uygulamalar tanıtılmaktadır.
İyi giriş/çıkış çiftleri ile ilgili yüzlerce örneğiniz varsa model ayarlama seçeneğini de kullanabilirsiniz.
Jeton sınırlarını anlama
Jetonları nasıl sayacağınızı ve sınırlarını daha iyi anlamak için Jeton kılavuzumuzu okuyun.
Bilinen sorunlar
- API yalnızca belirli dilleri destekler. Desteklenmeyen dillerde istem göndermek beklenmedik veya hatta engellenen yanıtlar oluşturabilir. Güncellemeler için kullanılabilir dillere göz atın.
Hata bildir
Sorularınız varsa Google Yapay Zeka geliştirici forumundaki tartışmaya katılın.