Aşağıdaki durumlarda ortaya çıkan yaygın sorunları teşhis etmenize ve çözmenize yardımcı olması için Gemini API'yi çağırıyorsunuz. API anahtarı sorunlarıyla karşılaşırsanız API anahtarı kurulum kılavuzuna uygun şekilde API anahtarınızı kullanmanız gerekir.
Hata kodları
Aşağıdaki tabloda, karşılaşabileceğiniz yaygın hata kodları ve açıklamalarına ve sorun giderme adımlarına bakın:
| HTTP Kodu | Durum | Açıklama | Çözüm |
| 400 | GEÇERSİZ_BAĞ_DEĞİŞKEN | İsteğin gövdesi hatalı. | İstek biçimi, örnekler ve desteklenen sürümler için API referansını inceleyin. Daha yeni bir API sürümündeki özelliklerin eski bir uç noktayla kullanılması hatalara neden olabilir. |
| 400 | FAILED_PRECONDITION | Gemini API ücretsiz katmanı ülkenizde kullanılamıyor. Lütfen Google AI Studio'daki projenizde faturalandırmayı etkinleştirin. | 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. | 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 | Oran sınırını aştınız. | Modelin hız sınırı dahilinde olduğunuzdan emin olun. Gerekirse kota artışı isteyin. |
| 500 | DAHİLİ | Google tarafında beklenmeyen bir hata oluştu. | Biraz bekleyip isteğinizi tekrar deneyin. Yeniden 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 kullanılmamış olabilir. | Biraz bekleyip isteğinizi tekrar deneyin. Yeniden denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak bildirin. |
Model parametresi hataları için API çağrılarınızı kontrol etme
Model parametrelerinizin aşağıdaki değerlerde 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 |
Tekliflerinizi otomatikleştirmek ve optimize etmek için
get_model (Python)
değerini belirleyin.
|
| TopP | 0,0-1,0 |
Parametre değerlerini kontrol etmenin yanı sıra, verilerinizi kontrol etmek için doğru
API sürümü (ör. /v1 veya /v1beta) ve
istediğiniz özellikleri destekleyen bir model seçin. Örneğin, bir özellik Beta sürümündeyse
bu sürüm yalnızca /v1beta API sürümünde kullanılabilecek.
Doğru modele sahip olup olmadığınızı kontrol edin
Şu adreste listelenen desteklenen bir modeli kullandığınızdan emin olun: modeller sayfasını ziyaret edin.
Güvenlik sorunları
API çağrınızdaki bir güvenlik ayarı nedeniyle bir istem engellendiğini görürseniz API çağrısında ayarladığınız filtrelere göre istemi inceleyin.
BlockedReason.OTHER görürseniz sorgu veya yanıt, şartları ihlal ediyor olabilir
ya da başka şekilde desteklenmemesi gerekir.
Model çıkışını iyileştirme
Daha kaliteli model çıkışları için daha yapılandırılmış istemler yazmayı keşfedin. İlgili içeriği oluşturmak için kullanılan istem tasarımına giriş sayfası tanıtımları size yardımcı olacak bazı temel kavramlar, stratejiler ve en iyi uygulamalar.
Yüzlerce iyi giriş/çıkış çifti örneğiniz varsa, bunları model ayarlamayı düşünün.
Jeton sınırlarını anlama
Nasıl yapıldığını daha iyi anlamak için Jeton kılavuzumuzu okuyun yaygın olarak kullanılan bir araçtır.
Bilinen sorunlar
- API yalnızca İngilizceyi desteklemektedir. Farklı dillerde istem göndermek beklenmedik hatta engellenmiş yanıtlar verebilir. Kullanılabilir dil bölümüne bakın.
Hata bildir
Google Yapay Zeka geliştirici forumundaki tartışmaya katılın göz atın.