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. Genel olarak, Gemini API arka uç hizmetini veya istemci SDK'larını kullanabilirsiniz. İstemci SDK'larımız şu depolarda açık kaynaklı olarak bulunuyor:
- generative-ai-python
- generative-ai-js
- generative-ai-android
- generative-ai-swift
- generative-ai-dart
- generative-ai-go
API anahtarı sorunlarıyla karşılaşırsanız API anahtarı kurulum kılavuzuna uygun şekilde API anahtarınızı kullanmanız gerekir.
Gemini API arka uç hizmeti hata kodları
Aşağıdaki tabloda, karşılaşabileceğiniz yaygın arka uç hata kodları bir açıklama ekleyin:
| HTTP Kodu | Durum | Açıklama | Örnek | Çözüm |
| 400 | INVALID_ARGUMENT | İsteğin gövdesi hatalı. | İsteğinizde bir yazım hatası veya isteğinizde eksik bir zorunlu alan var. | İ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. | Ücretsiz katmanın desteklenmediği ve Google AI Studio'daki projenizde faturalandırmayı etkinleştirmediğiniz bir bölgede istekte bulunuyorsunuz. | 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ını kullanıyorsunuz. siz doğru kimlik doğrulama yapılmadan, hassaslaştırılmış bir model kullanmaya çalışan kullanıcılar. | API anahtarınızın ayarlandığından ve doğru erişime sahip olduğundan emin olun. Ayrıca, hassaslaştırılmış modelleri kullanmak için uygun bir kimlik doğrulama sürecinden geçtiğinizden emin olun. |
| 404 | NOT_FOUND | İstenen kaynak bulunamadı. | İsteğinizde belirtilen resim, ses veya video dosyası 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. | Ücretsiz katman Gemini API ile dakika başına çok fazla istek gönderiyorsunuz. | 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. | Giriş bağlamınız çok uzun. | Giriş bağlamınızı azaltın veya geçici olarak başka bir modele (ör. Gemini 1.5 Pro'dan Gemini 1.5 Flash'a) geçip çalışıp çalışmadığına bakın. Alternatif olarak, kısa bir süre bekleyip yeniden istekte bulunabilirsiniz. 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. | Hizmetin kapasitesi geçici olarak tükeniyor. | Geçici olarak başka bir modele (ör. Gemini 1.5 Pro'dan Gemini 1.5 Flash'a) geçin ve çalışıp çalışmadığına bakın. Alternatif olarak, kısa bir süre bekleyip yeniden istekte bulunabilirsiniz. Yeniden denedikten sonra sorun devam ederse lütfen Google AI Studio'daki Geri bildirim gönder düğmesini kullanarak bildirin. |
| 504 | DEADLINE_EXCEEDED | Hizmet, verilen son tarihe kadar işlemeyi tamamlayamıyor. | İsteminiz (veya bağlamınız) zamanında işlenemeyecek kadar büyük. | Daha büyük bir "zaman aşımı" ayarlama kullanabilirsiniz. |
Python istemci SDK'sı hata kodları
Aşağıdaki tabloda yaygın olarak kullanılan Python istemci SDK'sı hatası ve bunların nedenleri hakkında açıklamalar içerir:
| İstisna/Hata Türü | Sınıf | Açıklama |
|---|---|---|
| BlockedPromptException | google.generativeai.types.BlockedPromptException | İstem, güvenlik nedeniyle engellendi. |
| BrokenResponseError | google.generativeai.types.BrokenResponseError | Akış yanıtı bozuk. Sohbet geçmişi gibi tam yanıt gerektiren bir öğeye erişilirken görüntülenir. Yığın izlemede (stack trace) sağlanan hata ayrıntılarını inceleyin. |
| IncompleteIterationError | google.generativeai.types.IncompleteIterationError | Tam bir API yanıtı gerektiren ancak akış yanıtının tam olarak yinelenmediği bir öğeye erişilirken yükseltildi. Yineleyiciyi kullanmak için yanıt nesnesinde resolve() çağrısı yapın. |
| StopCandidateException | google.generativeai.types.StopCandidateException | API olağanüstü bir finish_reason ile yanıt verdi. Nasıl devam edeceğinizle ilgili tavsiye için gerekçeyi kontrol edin. |
| PermissionDenied | google.api_core.exceptions.PermissionDenied | İstenen kaynak (ör. model) için izniniz yok. |
| ResourceExhausted | google.api_core.exceptions.ResourceExhausted | Kotanız doldu. Lütfen kısa bir süre bekleyip tekrar deneyin. Bu hataları düzeltmek için otomatik yeniden denemeler ayarlayabilirsiniz. |
| AlreadyExists | google.api_core.exceptions.AlreadyExists | Aynı kimliğe sahip ayarlanmış bir model zaten var. Yeni bir model üzerinde ince ayar yaparken lütfen benzersiz bir model kimliği belirtin. |
| InvalidArgument | google.api_core.exceptions.InvalidArgument | Geçersiz bağımsız değişken. Örneğin, dosyanın çok büyük olması ve yük boyutu sınırını aşması buna örnek gösterilebilir. Diğeri geçersiz bir API anahtarı sağlıyor. |
| DefaultCredentialsError | google.auth.exceptions.DefaultCredentialsError | Kimlik doğrulama başarısız oldu. Lütfen API anahtarınızı bir kez daha kontrol edip tekrar deneyin. |
| RetryError | google.api_core.exceptions.RetryError | gRPC'yi desteklemeyen bir proxy kullanılırken ortaya çıkabilir. REST aktarımını genai.configure(..., transport="rest") ile kullanmayı deneyin. |
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.
Anlatım sorunu
Modelin RECITATION nedeniyle çıktı üretmeyi durdurduğunu görürseniz bu model çıkışının belirli verilere benzeyebileceği anlamına gelir. Bunu düzeltmek için mümkün olduğunca benzersiz ve daha yüksek bir sıcaklık kullanın.
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 öğe demektir.
Bilinen sorunlar
- API yalnızca belirli sayıda dili destekler. İstemleri gönderme: desteklenmeyen diller beklenmedik, hatta engellenmiş yanıtlar verebilir. Görüntüleyin kullanıma sunulan dilleri kontrol edin.
Hata bildir
Google Yapay Zeka geliştirici forumundaki tartışmaya katılın göz atın.