Sorun giderme kılavuzu

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ç hizmeti veya istemci SDK'ları ile ilgili sorunlar yaşayabilirsiniz. İstemci SDK'larımız aşağıdaki depolarda açık kaynaklıdır:

• python-genai
• js-genai
• go-genai

API anahtarıyla ilgili sorunlarla karşılaşırsanız API anahtarı kurulum kılavuzuna göre API anahtarınızı doğru şekilde ayarladığınızı doğrulayın.

Gemini API arka uç hizmeti hata kodları

Aşağıdaki tabloda, karşılaşabileceğiniz yaygın arka uç hata kodları, bunların nedenlerine ilişkin açıklamalar ve sorun giderme adımları listelenmiştir:

Model parametresi hataları için API çağrılarınızı kontrol etme

Model parametrelerinizin aşağıdaki değerler içinde olduğunu doğrulayın:

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. Örneğin, bir özellik beta sürümündeyse 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 modeli kullandığınızı doğrulayın.

2.5 modellerinde daha yüksek gecikme veya jeton kullanımı

2.5 Flash ve Pro modellerinde daha yüksek gecikme veya jeton kullanımı gözlemliyorsanız bunun nedeni, kaliteyi artırmak için düşünme özelliğinin varsayılan olarak etkinleştirilmiş olması olabilir. Hıza öncelik veriyorsanız veya maliyetleri en aza indirmeniz gerekiyorsa düşünme sürecini ayarlayabilir ya da devre dışı bırakabilirsiniz.

Rehberlik ve örnek kod için düşünme sayfasına bakın.

Güvenlik sorunları

API çağrınızdaki bir güvenlik ayarı nedeniyle istemin engellendiğini görürseniz API çağrısında ayarladığınız filtreler açısından istemi inceleyin.

BlockedReason.OTHER simgesini görüyorsanız sorgu veya yanıt, Hizmet Şartları'nı ihlal ediyor ya da başka bir şekilde desteklenmiyor olabilir.

Okuma sorunu

Modelin, RECITATION (Tekrar) nedeniyle çıkış oluşturmayı durdurduğunu görüyorsanız 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.

Tekrarlanan jeton sorunu

Çıkış jetonlarının tekrarlandığını görüyorsanız bunları azaltmak veya tamamen ortadan kaldırmak için aşağıdaki önerileri deneyin.

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
        

        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
      

Model çıktısını iyileştirme

Daha kaliteli model çıkışları için daha yapılandırılmış istemler yazmayı deneyin. İstem mühendisliği kılavuzu 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 ayarlamayı da düşünebilirsiniz.

Jeton sınırlarını anlama

Jetonların nasıl sayıldığını ve sınırlarını daha iyi anlamak için Jeton kılavuzumuzu inceleyin.

Bilinen sorunlar

• API yalnızca belirli dilleri destekler. Desteklenmeyen dillerde istem göndermek beklenmedik veya hatta engellenen yanıtlar üretebilir. Güncellemeler için kullanılabilir dilleri inceleyin.

Hata bildir

Sorularınız varsa Google Yapay Zeka geliştirici forumunda tartışmaya katılın.