Gemini API'yi çağırdığınızda ortaya çıkan yaygın sorunları teşhis etmenize ve çözmenize yardımcı olması için bu kılavuzdan yararlanabilirsiniz. API anahtarı sorunlarıyla karşılaşırsanız API anahtarınızı API anahtarı kurulum kılavuzuna göre doğru şekilde ayarladığınızdan emin olun.
Hata kodları
Aşağıdaki tabloda, karşılaşabileceğiniz yaygın hata kodları, nedenleri ve sorun giderme adımlarıyla ilgili açıklamalar yer almaktadır:
| HTTP Kodu | Durum | Açıklama | Çözüm |
| 400 | INVALID_ARGUMENT | İsteğin gövdesi hatalı biçimlendirilmiş. | İstek biçimi, örnekler ve desteklenen sürümler için API referansını kontrol edin. Eski bir uç noktayla daha yeni bir API sürümündeki özelliklerin kullanılması hatalara neden olabilir. |
| 403 | PERMISSION_DENIED | API anahtarınız gerekli izinlere sahip değil. | API anahtarınızın ayarlandığından ve doğru erişime sahip olduğundan emin olun. |
| 404 | NOT_FOUND | İstenen kaynak bulunamadı. | İsteğinizdeki tüm parametrelerin API sürümünüz için geçerli olup olmadığını kontrol edin. |
| 429 | RESOURCE_EXHAUSTED | Döviz kuru sınırını aştınız. | Modelin ücret sınırı dahilinde olduğunuzdan emin olun. Gerekirse kota artışı isteğinde bulunun. |
| 500 | DAHİLİ | Google tarafında beklenmeyen bir hata oluştu. | Biraz bekleyip isteğinizi tekrar deneyin. Tekrar denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak bildirin. |
| 503 | UNAVAILABLE | Hizmet geçici olarak aşırı yüklenmiş veya çalışmıyor olabilir. | Biraz bekleyip isteğinizi tekrar deneyin. Tekrar denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak bildirin. |
API çağrılarınızda model parametresi hatalarını kontrol etme
Model parametrelerinizin aşağıdaki değerler dahilinde 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 model için maksimum jeton sayısını belirlemek amacıyla get_model (Python) 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 istediğiniz özellikleri
destekleyen bir model ekleyin. Örneğin, Beta sürümünde olan bir özellik yalnızca /v1beta API sürümünde kullanılabilir.
Doğru modele sahip olup olmadığınızı kontrol edin
Desteklenen bir model kullandığınızdan emin olun. Kullanıma hazır tüm modelleri almak için list_models (Python) kullanın.
Güvenlik sorunları
API çağrınızdaki bir güvenlik ayarı nedeniyle bir istem engellendiğini görürseniz isteği, API çağrısında ayarladığınız filtrelerle ilgili olarak inceleyin.
BlockedReason.OTHER ifadesini görüyorsanız sorgu veya yanıt, hizmet şartlarını ihlal ediyor ya da desteklenmiyor olabilir.
Model çıkışını iyileştirme
Daha yüksek kaliteli model çıkışları için daha yapılandırılmış istemler yazmayı keşfedin. İstem tasarımına giriş sayfasında, başlamanıza yardımcı olacak bazı temel kavramlar, stratejiler ve en iyi uygulamalar tanıtılmaktadır.
Yüzlerce iyi giriş/çıkış çifti örneğiniz varsa model ayarlaması yapmayı da düşünebilirsiniz.
Jeton sınırlarını anlama
Giriş ve çıkış jetonu sınırları dahil, modellerle ilgili ek meta veriler almak için ModelService API'yi kullanın.
İsteminizin kullandığı jetonları almak üzere sohbet modelleri için countMessageTokens ve metin modelleri için countTextTokens kullanın.
Bilinen sorunlar
- Google AI Studio için mobil destek: Web sitesini mobil cihazlarda açabilirsiniz ancak küçük ekranlar için optimize edilmemiştir.
- API yalnızca İngilizceyi desteklemektedir. Farklı dillerde istem göndermek beklenmedik veya engellenmiş yanıtlar verebilir. Güncellemeler için kullanılabilir dillere bakın.
Hata bildirin
Soru sormak veya özellik isteği ya da hata göndermek için GitHub'da sorun kaydı oluşturun.