دليل تحديد المشاكل وحلّها

استخدِم هذا الدليل لمساعدتك في تحديد المشاكل الشائعة وحلّها عند طلب Gemini API. قد تواجه مشاكل من خدمة الخلفية في Gemini API أو من حِزم SDK للعميل. حِزم SDK للعميل مفتوحة المصدر في المستودعات التالية:

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

إذا واجهت مشاكل في مفتاح واجهة برمجة التطبيقات، تأكَّد من إعداد مفتاح واجهة برمجة التطبيقات بشكلٍ صحيح وفقًا لـ دليل إعداد مفتاح واجهة برمجة التطبيقات.

رموز الخطأ في خدمة Gemini API في الخلفية

يسرد الجدول التالي رموز الخطأ الشائعة في الخلفية التي قد تواجهها، بالإضافة إلى تفسيرات لأسبابها وخطوات تحديد المشاكل وحلّها:

التحقّق من طلبات البيانات من واجهة برمجة التطبيقات بحثًا عن أخطاء في مَعلمات النموذج

تأكَّد من أنّ مَعلمات النموذج ضمن القيم التالية:

بالإضافة إلى التحقّق من قيم المَعلمات، تأكَّد من استخدام إصدار واجهة برمجة التطبيقات الصحيح (مثل /v1 أو /v1beta) والنموذج الذي يتيح الميزات التي تحتاج إليها. على سبيل المثال، إذا كانت إحدى الميزات في إصدار تجريبي، لن تتوفّر إلا في إصدار واجهة برمجة التطبيقات /v1beta.

التأكّد من استخدام النموذج المناسب

تأكَّد من استخدام نموذج متوافق مدرَج في صفحة النماذج.

زيادة وقت الاستجابة أو استخدام الرموز المميّزة مع نماذج 2.5

إذا لاحظت زيادة في وقت الاستجابة أو استخدام الرموز المميّزة مع نموذجَي 2.5 Flash وPro، قد يرجع ذلك إلى أنّ ميزة "التفكير" مفعَّلة تلقائيًا لتحسين الجودة. إذا كنت تعطي الأولوية للسرعة أو تحتاج إلى تقليل التكاليف، يمكنك تعديل ميزة "التفكير" أو إيقافها.

راجِع صفحة "التفكير" للحصول على إرشادات ورمز نموذجي.

مشاكل متعلقة بالأمان

إذا ظهرت لك رسالة تفيد بأنّه تم حظر طلب بسبب إعدادات الأمان في طلب البيانات من واجهة برمجة التطبيقات، راجِع الطلب وفقًا للفلاتر التي ضبطتها في طلب البيانات من واجهة برمجة التطبيقات.

إذا ظهرت لك الرسالة BlockedReason.OTHER، قد يكون الاستعلام أو الرد مخالفًا لـ بنود الخدمة أو غير متوافق.

مشكلة في التلاوة

إذا توقّف النموذج عن إنشاء الردود بسبب السبب RECITATION، يعني ذلك أنّ مخرجات النموذج قد تشبه بيانات معيّنة. لحلّ هذه المشكلة، حاوِل جعل الطلب أو السياق فريدًا قدر الإمكان واستخدِم درجة عشوائية أعلى.

مشكلة في الرموز المميّزة المتكرّرة

إذا ظهرت لك رموز مميّزة متكرّرة في الرد، جرِّب الاقتراحات التالية للمساعدة في تقليلها أو إزالتها.

          # 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.
      

مفاتيح واجهة برمجة التطبيقات المحظورة أو غير العاملة

يصف هذا القسم كيفية التحقّق مما إذا كان مفتاح Gemini API محظورًا وما يجب فعله حيال ذلك.

فهم أسباب حظر المفاتيح

لقد حدّدنا ثغرة أمنية قد تكون بعض مفاتيح واجهة برمجة التطبيقات قد تم الكشف عنها للعلن. لحماية بياناتك ومنع الوصول غير المصرَّح به إليها، حظرنا بشكل استباقي هذه المفاتيح المعروفة التي تم تسريبها من الوصول إلى Gemini API.

التأكّد مما إذا كانت مفاتيحك متأثرة

إذا كان مفتاحك معروفًا بأنّه تم تسريبه، لن تتمكّن بعد الآن من استخدامه مع Gemini API. يمكنك استخدام Google AI Studio لمعرفة ما إذا كان أي من مفاتيح واجهة برمجة التطبيقات محظورًا من طلب Gemini API وإنشاء مفاتيح جديدة. قد يظهر لك أيضًا الخطأ التالي عند محاولة استخدام هذه المفاتيح:

Your API key was reported as leaked. Please use another API key.

الإجراءات المتخذة بشأن مفاتيح واجهة برمجة التطبيقات المحظورة

عليك إنشاء مفاتيح واجهة برمجة تطبيقات جديدة لعمليات دمج Gemini API باستخدام Google AI Studio. ننصحك بشدة بمراجعة ممارسات إدارة مفاتيح واجهة برمجة التطبيقات لضمان الحفاظ على أمان مفاتيحك الجديدة وعدم الكشف عنها للعلن.

رسوم غير متوقَّعة بسبب الثغرة الأمنية

أرسِل طلب دعم بشأن الفوترة. يعمل فريق الفوترة على حلّ هذه المشكلة، وسنرسل إليك آخر الأخبار في أقرب وقت ممكن.

إجراءات الأمان التي تتخذها Google بشأن المفاتيح التي تم تسريبها

كيف ستساعد Google في الحفاظ على أمان حسابي من تجاوز التكاليف وإساءة الاستخدام إذا تم تسريب مفاتيح واجهة برمجة التطبيقات؟

• نحن بصدد إصدار مفاتيح واجهة برمجة التطبيقات عندما تطلب مفتاحًا جديدًا باستخدام Google AI Studio، وسيقتصر ذلك تلقائيًا على Google AI Studio فقط ولن يقبل المفاتيح من الخدمات الأخرى. سيساعد ذلك في منع أي استخدام غير مقصود لمفاتيح متعددة.
• نحن نحظر تلقائيًا مفاتيح واجهة برمجة التطبيقات التي تم تسريبها واستخدامها مع Gemini API، ما يساعد في منع إساءة استخدام التكاليف وبيانات تطبيقك.
• ستتمكّن من الاطّلاع على حالة مفاتيح واجهة برمجة التطبيقات ضِمن Google AI Studio، وسنعمل على التواصل بشكل استباقي عندما نحدّد أنّ مفاتيح واجهة برمجة التطبيقات قد تم تسريبها لاتخاذ إجراء فوري.

تحسين مخرجات النموذج

للحصول على ردود نموذجية بجودة أعلى، جرِّب كتابة طلبات أكثر تنظيمًا. تقدّم صفحة دليل هندسة الطلبات بعض المفاهيم الأساسية والاستراتيجيات وأفضل الممارسات لمساعدتك في البدء.

فهم حدود الرموز المميّزة

راجِع دليل الرموز المميّزة لفهم كيفية عدّ الرموز المميّزة وحدودها بشكلٍ أفضل.

المشاكل المعروفة

• لا تتيح واجهة برمجة التطبيقات سوى عدد من اللغات المحدّدة. يمكن أن يؤدي إرسال طلبات بلغات غير متوافقة إلى ظهور ردود غير متوقَّعة أو حتى محظورة. راجِع اللغات المتاحة للاطّلاع على آخر الأخبار.

الإبلاغ عن خطأ

انضم إلى المناقشة في منتدى مطوّري الذكاء الاصطناعي من Google إذا كانت لديك أسئلة.