يساعدك هذا الدليل في تشخيص المشكلات الشائعة وحلها في حالة في Gemini API في حال مواجهة مشاكل بشأن مفتاح واجهة برمجة التطبيقات، تأكَّد من أنّك ضبطت الإعدادات مفتاح واجهة برمجة التطبيقات بشكلٍ صحيح وفقًا لدليل إعداد مفتاح واجهة برمجة التطبيقات.
رموز الخطأ
يسرد الجدول التالي رموز الخطأ الشائعة التي قد تواجهها، إلى جانب تفسيرات لأسبابها وخطوات تحديد المشاكل وحلّها:
| رمز HTTP | الحالة | الوصف | الحلّ |
| 400 | قيمة غير صالحة | نص الطلب مكتوب بشكلٍ غير صحيح. | يمكنك الاطّلاع على مرجع واجهة برمجة التطبيقات للاطّلاع على تنسيق الطلب والأمثلة والإصدارات المتوافقة. يمكن أن يؤدي استخدام ميزات من إصدار أحدث لواجهة برمجة التطبيقات مع نقطة نهاية قديمة إلى حدوث أخطاء. |
| 400 | FAILED_PRECONDITION | لا يتوفّر الإصدار المجاني من Gemini API في بلدك. يُرجى تفعيل الفوترة في مشروعك في Google AI Studio. | لاستخدام Gemini API، يجب إعداد خطة مدفوعة باستخدام Google AI Studio. |
| 403 | PERMISSION_DENIED | لا يتضمّن مفتاح واجهة برمجة التطبيقات الأذونات المطلوبة. | تحقَّق من ضبط مفتاح واجهة برمجة التطبيقات وأنّ لديه إذن الوصول الصحيح. |
| 404 | NOT_FOUND | لم يتم العثور على المورد المطلوب. | تحقَّق مما إذا كانت جميع المَعلمات في طلبك صالحة لإصدار واجهة برمجة التطبيقات. |
| 429 | RESOURCE_EXHAUSTED | لقد تجاوزت الحد الأقصى لمعدّل الزحف. | تأكَّد من أنّك ضمن الحدّ الأقصى لمعدّل الزحف للنموذج. يمكنك طلب زيادة الحصة إذا لزم الأمر. |
| 500 | للاستخدام الداخلي | حدث خطأ غير متوقع من جانب Google. | يُرجى الانتظار قليلاً وإعادة محاولة تقديم الطلب. إذا استمرت المشكلة بعد إعادة المحاولة، يُرجى الإبلاغ عنها باستخدام الزر إرسال ملاحظات في Google AI Studio. |
| 503 | UNAVAILABLE | قد تكون الخدمة متوقّفة أو تم تحميلها بشكل زائد مؤقتًا. | يُرجى الانتظار قليلاً وإعادة محاولة تقديم الطلب. إذا استمرت المشكلة بعد إعادة المحاولة، يُرجى الإبلاغ عنها باستخدام الزر إرسال ملاحظات في Google AI Studio. |
التحقّق من طلبات البيانات من واجهة برمجة التطبيقات بحثًا عن أخطاء مَعلمات النماذج
تأكّد من أنّ مَعلمات النموذج ضمن القيم التالية:
| مَعلمة النموذج | القيم (النطاق) |
| عدد المرشحين | 1-8 (عدد صحيح) |
| درجة الحرارة | من 0.0 إلى 1.0 |
| الحد الأقصى للرموز المميزة للمخرجات |
استخدام
get_model (Python)
لتحديد الحد الأقصى لعدد الرموز بالنموذج الذي تستخدمه.
|
| TopP | من 0.0 إلى 1.0 |
بالإضافة إلى التحقق من قيم المعلمات، تأكد من استخدام
إصدار واجهة برمجة التطبيقات (على سبيل المثال، /v1 أو /v1beta) و
نموذج يدعم الميزات التي تحتاج إليها. على سبيل المثال، إذا كانت إحدى الميزات في مرحلة تجريبية
، فلن يتوفر إلا في إصدار واجهة برمجة التطبيقات /v1beta.
التحقق من استخدام النموذج الصحيح
تأكد من أنك تستخدم نموذجًا متوافقًا مدرج في صفحة النماذج.
مشاكل تتعلق بالسلامة
إذا ظهرت رسالة مطالبة تم حظرها بسبب إعداد أمان في طلب البيانات من واجهة برمجة التطبيقات، راجِع الطلب في ما يتعلق بالفلاتر التي أعددتها في طلب البيانات من واجهة برمجة التطبيقات.
إذا رأيت BlockedReason.OTHER، يعني هذا أنّ طلب البحث أو الردّ يخالف البنود.
أو ألّا تكون غير متاحة بأي شكل آخر.
تحسين ناتج النموذج
للحصول على نتائج نموذج ذات جودة أعلى، ننصحك بكتابة المزيد من الطلبات المنظَّمة. تشير رسالة الأشكال البيانية تقدم صفحة مقدمة إلى تصميم الطلب وبعض المفاهيم الأساسية والاستراتيجيات وأفضل الممارسات للبدء.
إذا كان لديك مئات الأمثلة على أزواج الإدخال/الإخراج الجيدة، فيمكنك أيضًا ننصحك بضبط النموذج.
فهم حدود الرموز المميّزة
الاطّلاع على دليل الرموز المميّزة لفهم كيفية إجراء ذلك بشكل أفضل لحساب الرموز المميزة وحدودها.
المشاكل المعروفة
- لا تدعم واجهة برمجة التطبيقات سوى اللغة الإنجليزية. يمكن أن يؤدي إرسال الطلبات بلغات مختلفة إلى ينتج عنها ردودًا غير متوقعة أو حتى محظورة. عرض المتاح اللغات للحصول على التحديثات.
الإبلاغ عن خطأ
انضم إلى المناقشة في منتدى مطوّري تكنولوجيات الذكاء الاصطناعي من Google إذا كانت لديك أسئلة