الأسئلة الشائعة وتحديد المشاكل وحلّها

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

لماذا تغيّر الاسم من "Vertex AI في Firebase" إلى "Firebase AI Logic"؟

في عام 2024، أطلقنا مجموعة من حِزم تطوير البرامج (SDK) لعملاء Firebase التي يمكنها استخدام Vertex AI Gemini API بالإضافة إلى بوابة وكيل Firebase لحماية واجهة برمجة التطبيقات (IDE) من إساءة الاستخدام وتفعيل عمليات الدمج مع منتجات Firebase الأخرى. أطلقنا على منتجنا اسم "Vertex AI في Firebase"، ووصف اسم المنتج هذا بدقة حالات الاستخدام المتاحة لمنتجنا في ذلك الوقت.

ومنذ ذلك الحين، وسّعنا إمكانات منتجنا. على سبيل المثال، اعتبارًا من أيار (مايو) 2025، نقدّم الآن دعمًا لميزة Gemini Developer API، بما في ذلك إمكانية حماية Gemini Developer API من إساءة الاستخدام من خلال عملية الدمج مع Firebase App Check.

نتيجةً لذلك، لم يعُد اسم "Vertex AI في Firebase" يمثّل بدقة النطاق الموسّع لمنتجنا. لذلك، اخترنا اسمًا جديدًا هو Firebase AI Logic، وهو يعكس بشكل أفضل مجموعة الميزات المتطوّرة التي نقدّمها ويسمح لنا بمواصلة توسيع نطاق المحتوى الذي نقدمه في المستقبل.

اطّلِع على دليل نقل البيانات للتأكّد من الحصول على جميع الميزات الأحدث من Firebase AI Logic (وبدء استخدام Gemini Developer API اختياريًا).

ما هي الاختلافات بين استخدام Gemini Developer API وVertex AI Gemini API؟

في ما يلي بعض الاختلافات بين موفِّري خدمة "Gemini API" بشكل عام بغض النظر عن كيفية الوصول إليهما:

• الأسعار

  • يوفّر Gemini Developer API "خطة مجانية" بالإضافة إلى أسعار الدفع حسب الاستخدام.

  • عند استخدام Vertex AI Gemini API مع Firebase AI Logic، يتطلّب ذلك دائمًا خطة أسعار Blaze المستندة إلى الدفع حسب الاستخدام.

  يُرجى العِلم أنّ موفّري واجهتَي برمجة التطبيقات هما من النوع المدفوع عند الاستخدام، ولكنهما يقدّمان أسعارًا مختلفة (يمكنك الاطّلاع على مزيد من المعلومات في المستندات الخاصة بكل منهما).

• حدود الأسعار (الحصة)

  • تم ضبط حدود واضحة لسعر الصرف في Gemini Developer API.

  • يستخدم Vertex AI Gemini API "الحصة المشترَكة الديناميكية (DSQ)" التي يشترك فيها جميع المستخدمين الذين يستخدمون هذا النموذج في هذه المنطقة. يمكنك أيضًا اختياريًا إعداد معدل نقل البيانات المقدَّم (PT).

• تحديد الموقع الجغرافي للوصول إلى النموذج

  • لا يتيح لك سوى Vertex AI Gemini API اختيار الموقع الجغرافي الذي تصل منه إلى النموذج.

يعرض الجدول التالي مدى توفّر الميزات التي يُطرح عنها أسئلة شائعة في مقدّمي خدمة "Gemini API". ينطبق هذا الجدول على وجه التحديد عند استخدام حِزم تطوير البرامج (SDK) لعملاء Firebase AI Logic.

¹ إنّ واجهة برمجة التطبيقات Files API لنظام التشغيل Gemini Developer API غير متوافقة مع Firebase AI Logic حِزم تطوير البرامج (SDK).

هل يمكنني استخدام كل من Gemini Developer API وVertex AI Gemini API؟

نعم، يمكنك تفعيل موفّري "Gemini API" في مشروعك على Firebase، ويمكنك استخدام كلتا وجهتَي برمجة التطبيقات في تطبيقك نفسه.

للتبديل بين موفّري واجهة برمجة التطبيقات في الرمز البرمجي، ما عليك سوى التأكّد من ضبط خدمة الخلفية بشكلٍ مناسب في الرمز البرمجي.

ما هي واجهات برمجة التطبيقات المطلوبة؟ كيف يمكنني تفعيلها؟

لاستخدام حِزم تطوير البرامج (SDK) Firebase AI Logic مع Gemini Developer API، يجب أن يكون مشروعك مزوّدًا بواجهتَي برمجة التطبيقات التاليتَين المفعّلتَين:

• Gemini Developer API (generativelanguage.googleapis.com)
• Firebase AI Logic واجهة برمجة التطبيقات (firebasevertexai.googleapis.com)

يجب تفعيل هاتين الواجهات باستخدام وحدة تحكّم Firebase:

1. في وحدة تحكُّم Firebase، انتقِل إلى صفحة Firebase AI Logic.

2. انقر على البدء.

3. انقر على Gemini Developer API للبدء.

   يؤدي ذلك إلى بدء سير عمل إرشادي يتيح لك تفعيل وجهتَي برمجة التطبيقات. ستنشئ الconsole أيضًا مفتاح واجهة برمجة تطبيقات Gemini، بالإضافة إلى إضافة واجهة برمجة التطبيقات Firebase AI Logic إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات Firebase.

ما هي النماذج التي يمكن استخدامها مع حِزم تطوير البرامج (SDK) من Firebase AI Logic؟

• يمكنك استخدام أيّ من نماذج Gemini وImagen 3 الأساسية مع حِزم تطوير البرامج (SDK) Firebase AI Logic، بما في ذلك الإصدارات التجريبية والإصدارات التجريبية. يمكنك الاطّلاع على قائمة بهذه الطُرز في مقالة التعرّف على الطُرز المتوافقة.

• لا يمكنك استخدام نماذج Gemini غير أساسية (مثل نماذج PaLM أو النماذج المحسّنة أو النماذج المستندة إلى Gemma) مع IDEs Firebase AI Logic.

  لا تتوافق Firebase AI Logic أيضًا مع طُرز Imagen القديمة أو imagen-3.0-capability-001.

• لا تتيح Gemini Developer API (بغض النظر عن كيفية الوصول إليها) استخدام imagen-3.0-fast-generate-001 أو الإصدار الأقدم imagen-3.0-generate-001.

نضيف إمكانات جديدة إلى حِزم تطوير البرامج (SDK) بشكل متكرّر، لذا يُرجى الرجوع إلى هذه الأسئلة الشائعة للاطّلاع على التحديثات (بالإضافة إلى ملاحظات الإصدار والمدوّنات والمشاركات على وسائل التواصل الاجتماعي).

ما الذي يجب فعله عند إيقاف النماذج نهائيًا؟

عند إصدار نسخة نموذجية ثابتة، نسعى جاهدين إلى ضمان توفّرها لمدة عام على الأقل. نُدرج "تاريخ الإيقاف النهائي" هذا في عدة مواضع في مستندات Google Cloud و Firebase (على سبيل المثال، في صفحة"النماذج").

عند إيقاف نموذج نهائيًا، ستتعذّر إرسال أي طلبات إلى هذا النموذج وستظهر رسالة الخطأ 404. لهذا السبب، ننصحك بشدة بإعداد واستخدام Firebase Remote Config حتى تتمكّن من تغيير الطراز والإصدار ديناميكيًا في تطبيقك بدون طرح إصدار جديد من تطبيقك.

عند تحديث تطبيقك لاستخدام إصدار جديد من النموذج، ننصحك باختبار تطبيقك للتأكّد من أنّ الردود لا تزال على النحو المتوقّع. يُرجى العِلم أنّه عند استخدام Firebase AI Logic، لا يكون هناك عادةً أي تعديل مطلوب لأي من الرموز البرمجية التي تستدعي النموذج.

في ما يلي تواريخ إيقاف الإصدارات المختلفة نهائيًا:

• طُرز Gemini 1.5 Pro:

  • ‫gemini-1.5-pro-002 (وgemini-1.5-pro): 24 سبتمبر 2025
  • gemini-1.5-pro-001: 24 أيار (مايو) 2025

• طُرز Gemini 1.5 Flash:

  • ‫gemini-1.5-flash-002 (وgemini-1.5-flash): 24 سبتمبر 2025
  • gemini-1.5-flash-001: 24 أيار (مايو) 2025

• Gemini 1.0 Pro Vision الطُرز: 21 نيسان (أبريل) 2025 (كان من المقرّر سابقًا أن يكون في 9 نيسان (أبريل) 2025)

• Gemini 1.0 Pro الطُرز: 21 نيسان (أبريل) 2025 (كان من المقرّر سابقًا أن يكون في 9 نيسان (أبريل) 2025)

كيف يمكنني ضبط حدّ أقصى للسعر لكل مستخدم؟

بشكلٍ تلقائي، يضبط Firebase AI Logic الحدّ الأقصى للطلبات لكلّ مستخدِم على 100 طلب في الدقيقة (RPM).

إذا كنت تريد تعديل الحد الأقصى للسعر لكل مستخدم، عليك تعديل إعدادات حصة Firebase AI Logic API.

مزيد من المعلومات حول حصة واجهة برمجة التطبيقاتFirebase AI Logic في هذه الصفحة، يمكنك أيضًا التعرّف على كيفية عرض حصّتك وتعديلها.

ما هي الأذونات المطلوبة لاستخدام حِزم تطوير البرامج (SDK) Firebase AI Logic؟

هل يستخدم Firebase AI Logic بياناتي لتدريب النماذج؟

اطّلِع على إدارة البيانات والذكاء الاصطناعي المسؤول.

هل يجب إدخال نوع MIME في طلبات الوسائط المتعددة؟ (مثل الصور وملفات PDF والفيديوهات والمدخلات الصوتية)

نعم، في كل طلب متعدد الوسائط، يجب دائمًا تقديم ما يلي:

• حجم الملف هو mimeType. اطّلِع على استثناء أدناه.

• الملف يمكنك تقديم الملف كبيانات مضمّنة أو تقديمه باستخدام عنوان URL الخاص به.

تعرَّف على أنواع ملفات الإدخال المتوافقة وكيفية تحديد نوع MIME والمرحلتَين لإرسال الملف في ملفات الإدخال المتوافقة ومتطلباتها.

استثناء لتضمين نوع MIME في طلبك

يُستثنى من تقديم نوع MIME إدخالات الصور المضمّنة لطلبات الواردة من تطبيقات Android وApple الأصلية.

توفّر حِزم Firebase AI Logic SDK لمنصّتَي Android وApple طريقة مبسّطة ومناسبة للمنصّة لمعالجة الصور في الطلبات، حيث يتم تحويل كل الصور (بغض النظر عن تنسيقها) إلى JPEG بنسبة جودة% 80 من جهة العميل قبل إرسالها إلى الخادم. وهذا يعني أنّه عند تقديم الصور كبيانات مضمّنة باستخدام حِزم تطوير البرامج (SDK) لمنصّتَي Android وApple، ليس عليك تحديد نوع MIME في الطلب.

يظهر هذا الإجراء المبسّط في مستندات Firebase AI Logic في أمثلة إرسال الصور المشفّرة بترميز base64 في الطلبات.

في ما يلي بعض المعلومات الإضافية حول هذه الميزة الخاصة بالنظام الأساسي:

• على أجهزة Android:

  • يمكنك الاستفادة من الطريقة المبسّطة للتعامل مع أنواع الصور الأصلية على المنصة (Bitmap) في طلبات التفاعل المتعدّدة التي تحتوي على صور كبيانات مضمّنة (راجِع المثال).

  • للحصول على مزيد من التحكّم في تنسيقات الصور والإحالات الناجحة، يمكنك تقديم الصور كملف InlineDataPart وتقديم نوع MIME المحدّد. على سبيل المثال:

    content { inlineData(/* PNG as byte array */, "image/png") }

• لأنظمة التشغيل من Apple:

  • يمكنك الاستفادة من الطريقة المبسّطة للتعامل مع أنواع الصور الأصلية على المنصة (UIImage وNSImage وCIImage وCGImage) في الطلبات المتعدّدة الوسائط التي تحتوي على صور كبيانات مضمّنة (راجِع المثال).

  • لمزيد من التحكّم في تنسيقات الصور والإحالات الناجحة، يمكنك تقديم الصور كملف InlineDataPart وتقديم نوع MIME المحدّد. على سبيل المثال:

    InlineDataPart(data: Data(/* PNG Data */), mimeType: "image/png")

هل هذه الميزات متاحة عند استخدام Firebase AI Logic؟ التخزين المؤقت للسياق، و"بحث Google" كأداة، و"بحث Google" كأداة مرجعية، وتنفيذ الرموز البرمجية، وتحسين النموذج، وإنشاء النماذج المضمّنة، والاسترجاع الدلالي؟

تتيح نماذج مختلفة أو Vertex AI Gemini API ميزة الاحتفاظ المؤقت بالسياق واستخدام "بحث Google" كأداة وربط البيانات بقاعدة المعلومات في "بحث Google" وتنفيذ الرموز البرمجية، وتحسين النموذج وإنشاء النماذج المضمّنة واسترجاع المحتوى بالاستناد إلى السياق، ولكن لا تتوفّر هذه الميزات عند استخدام Firebase AI Logic.

إذا أردت إضافة هذه الطلبات كطلبات ميزات أو التصويت على طلب ميزة حالي، يُرجى الانتقال إلى Firebase UserVoice.

ما هو مفتاح واجهة برمجة التطبيقات في Gemini؟

يستخدم Gemini Developer API "مفتاح واجهة برمجة التطبيقات Gemini" لتفويض المتصل. لذلك، إذا كنت تستخدم Gemini Developer API من خلال حِزم تطوير البرامج (SDK) Firebase AI Logic، ستحتاج إلى مفتاح صالح لواجهة برمجة التطبيقات Gemini في مشروعك على Firebase لإجراء طلبات إلى واجهة برمجة التطبيقات هذه.

يشير "مفتاح واجهة برمجة التطبيقات Gemini" إلى مفتاح واجهة برمجة التطبيقات الذي يتضمّن Gemini Developer API في القائمة المسموح لها بالوصول إلى واجهة برمجة التطبيقات.

عند تنفيذ خطوات عملية إعداد Firebase AI Logic في وحدة تحكّم Firebase، ننشئ مفتاح واجهة برمجة تطبيقات Gemini يقتصر استخدامه على Gemini Developer API فقط، ونُعدّ خدمةFirebase AI Logic الوكيل لاستخدام مفتاح واجهة برمجة التطبيقات هذا. يُعرف مفتاح Gemini واجهة برمجة التطبيقات الذي أنشأه Firebase باسم مفتاح واجهة برمجة التطبيقات لمطوّري Gemini (تم إنشاؤه تلقائيًا بواسطة Firebase) في صفحة بيانات الاعتماد في وحدة تحكّم Google Cloud.

اطّلِع على مزيد من المعلومات حول قيود واجهة برمجة التطبيقات لمفاتيح واجهة برمجة التطبيقات.

لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة بيانات تطبيقك عند استخدام حِزم تطوير البرامج (SDK) Firebase AI Logic. اطّلِع على مزيد من المعلومات حول كيفية الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.

هل يجب إضافة مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة بيانات تطبيقي المتوافق مع الأجهزة الجوّالة أو الويب؟

عند استخدام حِزم تطوير البرامج (SDK) Firebase AI Logic، لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة بيانات تطبيقك.

في الواقع، أثناء التطوير باستخدام حِزم تطوير البرامج (SDK) Firebase AI Logic، لا تتفاعل بشكل مباشر مع مفتاح واجهة برمجة التطبيقات Gemini. بدلاً من ذلك، ستشمل خدمة الوكيلFirebase AI Logic مفتاح واجهة برمجة التطبيقات Gemini داخليًا في كل طلب موجَّه إلى Gemini Developer API، بالكامل في الخلفية.

كيف يمكنني تغيير مفتاح واجهة برمجة التطبيقات Gemini المستخدَم للاتّصال بـ Gemini Developer API؟

عند استخدام حِزم تطوير البرامج (SDK) Firebase AI Logic، من غير المرجّح أن تحتاج إلى تغيير مفتاح واجهة برمجة التطبيقات Gemini. ومع ذلك، في ما يلي حالتان قد تحتاج فيها إلى إجراء ذلك:

• إذا تم تسريب المفتاح عن طريق الخطأ وأردت استبداله بمفتاح آمن جديد

• إذا حذفت المفتاح عن طريق الخطأ يُرجى العلم أنّه يمكنك إلغاء حذف المفتاح خلال 30 يومًا من الحذف.

في ما يلي كيفية تغيير مفتاح واجهة برمجة التطبيقات Gemini الذي تستخدمه حِزم تطوير البرامج (SDK) Firebase AI Logic:

1. إذا كان مفتاح واجهة برمجة التطبيقات Gemini الذي أنشأته Firebase لا يزال متوفّرًا، احذفه.

   يمكنك حذف مفتاح واجهة برمجة التطبيقات هذا في واجهات برمجة التطبيقات والخدمات > لوحة بيانات الاعتماد في وحدة تحكّم Google Cloud. يحمل الاسم:
   مفتاح Gemini Developer API (تم إنشاؤه تلقائيًا بواسطة Firebase).

2. في الصفحة نفسها من وحدة تحكّم Google Cloud، أنشئ مفتاح واجهة برمجة تطبيقات جديدًا. ننصحك بتسميته باسم مثل:
   مفتاح واجهة برمجة التطبيقات لمطوّري Gemini في Firebase.

3. أضِف إلى مفتاح واجهة برمجة التطبيقات الجديد قيودًا على واجهة برمجة التطبيقات واختَر Generative Language API فقط.
   يُشار إلى Gemini Developer API أحيانًا باسم "Generative Language API" في وحدة تحكّم Google Cloud.

   لا تُضِف أي قيود على التطبيقات، وإلا لن تعمل خدمة الخادم الوكيل Firebase AI Logic على النحو المتوقّع.

4. شغِّل الأمر التالي لضبط هذا المفتاح الجديد كمفتاح واجهة برمجة التطبيقاتGemini الذي يجب أن تستخدمه خدمة الوكيلFirebase AI Logic.

   PROJECT_ID="PROJECT_ID"
   GENERATIVE_LANGUAGE_API_KEY="DEVELOPER_CREATED_GEMINI_API_KEY"
   curl \
     -X PATCH \
     -H "x-goog-user-project: ${PROJECT_ID}" \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     "https://firebasevertexai.googleapis.com/v1beta/projects/${PROJECT_ID}/locations/global/config" \
     -d "{\"generativeLanguageConfig\": {\"apiKey\": \"${GENERATIVE_LANGUAGE_API_KEY}\"}}"
   

   اطّلِع على مزيد من المعلومات عن gcloud CLI.

يُرجى عدم إضافة مفتاح واجهة برمجة التطبيقات Gemini الجديد هذا إلى قاعدة بيانات رمز تطبيقك. اطّلِع على مزيد من المعلومات حول كيفية الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.

هل يمكنني استخدام "مفتاح واجهة برمجة التطبيقات في Firebase" كمفتاح واجهة برمجة التطبيقات في Gemini؟

لا، يجب عدم استخدام "مفتاح واجهة برمجة التطبيقات في Firebase" كمفتاح واجهة برمجة التطبيقات Gemini. ننصحك بشدة بعدم إضافة Gemini Developer API إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات Firebase.

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

في واجهات برمجة التطبيقات والخدمات > لوحة بيانات الاعتماد في وحدة تحكّم Google Cloud، إليك شكل مفاتيح واجهة برمجة التطبيقات Firebase:

بما أنّك تحتاج إلى إضافة مفتاح واجهة برمجة التطبيقات Firebase إلى قاعدة بيانات تطبيقك لكي تعمل واجهات برمجة التطبيقات المرتبطة بمنصّة Firebase، وبما أنّ Gemini Developer API مفوَّض من خلال مفتاح واجهة برمجة التطبيقات، ننصحك بشدة بعدم إضافة Gemini Developer API (المعروفة باسم "واجهة برمجة التطبيقات للغة التوليدية" في وحدة تحكّم Google Cloud) إلى القائمة المسموح بها لواجهات برمجة التطبيقات لمفتاح واجهة برمجة التطبيقات Firebase. وفي حال اتّباع هذه الخطوات، ستعرّض Gemini Developer API لخطر إساءة الاستخدام.

كيف يمكنني الحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini؟

توضّح الأسئلة الشائعة هذه بعض أفضل الممارسات المقترَحة للحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.

إذا كنت تتصل بـ Gemini Developer API مباشرةً من تطبيقك المتوافق مع الأجهزة الجوّالة أو الويب:

• استخدام حِزم SDK لعملاء Firebase AI Logic
• لا تُضِف مفتاح واجهة برمجة التطبيقات Gemini إلى قاعدة بيانات تطبيقك.

توفّر Firebase AI Logic خدمة وكيل تتضمّن داخليًا مفتاح واجهة برمجة التطبيقاتGemini في كل طلب موجَّه إلى Gemini Developer API، تمامًا في الخلفية.

بالإضافة إلى ذلك، ننصحك بشدة باتّباع الخطوات التالية:

• بعد بدء تطوير تطبيقك بشكل جدي، يمكنك الدمج مع Firebase App Check للمساعدة في حماية موارد الخلفية بالإضافة إلى واجهات برمجة التطبيقات المستخدَمة للوصول إلى نماذج التوليدية.

• لا تُعِد استخدام مفتاح واجهة برمجة التطبيقات Gemini الذي أنشأته Firebase خارج Firebase AI Logic. إذا كنت بحاجة إلى مفتاح واجهة برمجة تطبيقات Gemini لاستخدامٍ آخر، أنشئ مفتاحًا منفصلاً.

• بوجهٍ عام، يجب عدم تعديل مفتاح واجهة برمجة التطبيقات Gemini الذي تم إنشاؤه من خلال Firebase. يُعرف هذا المفتاح باسم مفتاح Gemini Developer API (تم إنشاؤه تلقائيًا بواسطة Firebase) في وحدة تحكّمGoogle Cloud.

  • لا تُضِف أي واجهات برمجة تطبيقات إضافية إلى قائمة واجهات برمجة التطبيقات المسموح بها لمفتاح Gemini الذي تم إنشاؤه من خلال Firebase. في القائمة المسموح لها بالوصول إلى واجهة برمجة التطبيقات، يجب أن يتضمّن مفتاح واجهة برمجة التطبيقات Gemini فقط واجهة برمجة التطبيقات Gemini Developer API (المعروفة باسم "Generative Language API" في وحدة تحكّم Google Cloud).

  • لا تُضِف أي قيود على التطبيقات، وإلا لن تعمل خدمة الخادم الوكيل Firebase AI Logic على النحو المتوقّع.

تعرّض مفتاح واجهة برمجة التطبيقات Gemini للاختراق. ما هو الإجراء الواجب اتّخاذه؟

إذا تم اختراق مفتاح واجهة برمجة التطبيقات Gemini، اتّبِع التعليمات لتغيير مفتاح واجهة برمجة التطبيقات Gemini الذي يتم استخدامه للاتّصال بـ Gemini Developer API.

راجِع أيضًا أفضل الممارسات المقترَحة لالحفاظ على أمان مفتاح واجهة برمجة التطبيقات Gemini.

كيف يمكنني حلّ خطأ 404 هذا؟ Firebase AI Logic genai config not found

إذا كنت تحاول استخدام Gemini Developer API وتلقّيت خطأ 404 يشير إلى Firebase AI Logic genai config not found، يعني ذلك عادةً أنّ مشروعك على Firebase لا يتضمّن مفتاح Gemini API صالحًا لاستخدامه مع حِزم تطوير البرامج (SDK) لعملاء Firebase AI Logic.

في ما يلي الأسباب الأكثر احتمالًا لهذا الخطأ:

• لم يتم إعداد مشروعك على Firebase بعد لتطبيق Gemini Developer API.

  الخطوات التي يجب اتّباعها:
  في وحدة تحكّم Firebase، انتقِل إلى صفحة Firebase AI Logic. انقر على البدء، ثم انقر على Gemini Developer API. فعِّل واجهة برمجة التطبيقات، وستُعدّ وحدة التحكّم مشروعك لتسجيله في Gemini Developer API. بعد إكمال سير العمل، يُرجى إعادة إرسال طلبك.

• إذا كنت قد أكملت مؤخرًا سير عمل إعداد Firebase AI Logic في وحدة تحكّم Firebase، قد لا يكون مفتاح Gemini API متاحًا بعد لجميع خدمات الخلفية المطلوبة في جميع المناطق.

  الإجراء الذي يجب اتّخاذه:
  يُرجى الانتظار بضع دقائق ثم إعادة إرسال طلبك.

• من المحتمل أنّه تم حذف مفتاح واجهة برمجة التطبيقات Gemini من مشروعك على Firebase.

  الإجراء الذي يجب اتّخاذه:
  يمكنك الاطّلاع على كيفية تغيير مفتاح واجهة برمجة التطبيقات Gemini المستخدَم في Firebase AI Logic.

كيف يمكنني حلّ خطأ 400 هذا؟ Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

إذا كنت تحاول إرسال طلب متعدد الوسائط باستخدام Cloud Storage for Firebase عنوان URL، قد يظهر لك الخطأ 400 التالي:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

يحدث هذا الخطأ بسبب مشروع لم يكن يتضمّن موظّفي خدمة تمّ توفيرهم تلقائيًا بشكلٍ صحيح عند تفعيل واجهة برمجة التطبيقات Vertex AI في المشروع. هذه مشكلة معروفة في بعض المشاريع، ونحن نعمل على حلّها على مستوى العالم.

في ما يلي الحلّ البديل لإصلاح مشروعك وتوفير عناوين URL الخاصة بخدمات هذه بشكل صحيح حتى تتمكّن من بدء تضمين عناوين URL الخاصة بCloud Storage for Firebase في طلباتك المتعدّدة الوسائط. يجب أن تكون مالكًا للمشروع، وعليك سوى إكمال هذه المجموعة من المهام مرة واحدة فقط لمشروعك.

1. يمكنك الوصول إلى gcloud CLI والمصادقة باستخدامه.
   أسهل طريقة لإجراء ذلك هي من Cloud Shell. يمكنك الاطّلاع على مزيد من المعلومات في ملف Google Cloud.

2. اتّبِع التعليمات المعروضة في المحطة الطرفية لتشغيل gcloud CLI في مشروعك على Firebase إذا طُلب منك ذلك.

   ستحتاج إلى رقم تعريف مشروعك على Firebase، والذي يمكنك العثور عليه في أعلى الشاشة settings إعدادات المشروع في وحدة تحكّم Firebase.

3. يمكنك توفير موظّفي الدعم المطلوبين في مشروعك من خلال تنفيذ العبارة التالية:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
   

4. انتظِر بضع دقائق للتأكّد من توفير موظّفي الدعم، ثم أعِد محاولة إرسال طلبك المتعدّد الوسائط الذي يتضمّن عنوان URL الخاص بموقع Cloud Storage for Firebase الإلكتروني.

إذا استمر ظهور هذا الخطأ بعد الانتظار لعدة دقائق، يُرجى التواصل مع فريق دعم Firebase.

كيف يمكنني حلّ خطأ 400 هذا؟ API key not valid. Please pass a valid API key.

إذا ظهر لك خطأ 400 يشير إلى API key not valid. Please pass a valid API key.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase غير متوفّر أو لم يتم إعداده لاستخدامه مع تطبيقك و/أو مشروعك على Firebase.

تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المدرَج في ملف/عنصر إعدادات Firebase يتطابق مع مفتاح واجهة برمجة التطبيقات لتطبيقك. يمكنك عرض جميع مفاتيح واجهة برمجة التطبيقات في ملف واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد لوحة وحدة تحكّم Google Cloud.

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

كيف يمكنني حلّ خطأ 403 هذا؟ Requests to this API firebasevertexai.googleapis.com ... are blocked.

إذا تلقّيت خطأ 403 يشير إلى Requests to this API firebasevertexai.googleapis.com ... are blocked.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase لا يتضمّن واجهة برمجة تطبيقات مطلوبة في القائمة المسموح بها للمنتج الذي تحاول استخدامه.

تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك يتضمّن كل واجهات برمجة التطبيقات المطلوبة المُدرَجة في القائمة المسموح بها ضمن "قيود واجهة برمجة التطبيقات" للمفتاح. بالنسبة إلى Firebase AI Logic، يجب أن يتضمّن مفتاح واجهة برمجة التطبيقات على الأقل واجهة برمجة التطبيقات Firebase AI Logic في القائمة المسموح بها.

يمكنك الاطّلاع على جميع مفاتيح واجهة برمجة التطبيقات في واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد لوحة في وحدة تحكّم Google Cloud.

كيف يمكنني حلّ خطأ 403 هذا؟ PERMISSION_DENIED: The caller does not have permission.

إذا تلقّيت خطأ 403 يعرض الرسالة التالية: PERMISSION_DENIED: The caller does not have permission.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase ينتمي إلى مشروع Firebase مختلف.

تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المدرَج في ملف/عنصر إعدادات Firebase يتطابق مع مفتاح واجهة برمجة التطبيقات لتطبيقك. يمكنك عرض جميع مفاتيح واجهة برمجة التطبيقات في ملف واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد لوحة وحدة تحكّم Google Cloud.

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