سوالات متداول و عیب یابی

با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

چرا نام از "Vertex AI in Firebase" به " Firebase AI Logic " تغییر کرد؟

در سال 2024، مجموعه‌ای از SDK مشتری Firebase را راه‌اندازی کردیم که می‌توانست از Vertex AI Gemini API و همچنین یک دروازه پروکسی Firebase برای محافظت از آن API در برابر سوء استفاده و فعال کردن ادغام با سایر محصولات Firebase استفاده کند. ما محصول خود را "Vertex AI in 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 نیاز دارد.

  توجه داشته باشید که دو ارائه‌دهنده API قیمت‌های پرداختی متفاوتی دارند (در اسناد مربوطه آنها بیشتر بیاموزید).

• محدودیت نرخ (سهمیه)

  • 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 خود فعال کنید و می توانید از هر دو API در خود برنامه خود استفاده کنید.

برای جابه‌جایی بین ارائه‌دهندگان API در کدتان، فقط مطمئن شوید که سرویس پشتیبان را به‌طور مناسب در کد خود تنظیم کرده‌اید .

API های مورد نیاز چیست؟ و چگونه آنها را فعال کنم؟

برای استفاده از Firebase AI Logic SDK با Gemini Developer API ، پروژه شما باید دو API زیر را فعال داشته باشد:

• Gemini Developer API ( generativelanguage.googleapis.com )
• Firebase AI Logic API ( firebasevertexai.googleapis.com )

شما باید این دو API را با استفاده از کنسول Firebase فعال کنید:

1. در کنسول Firebase ، به صفحه Firebase AI Logic بروید.

2. روی Get start کلیک کنید.

3. برای شروع با Gemini Developer API را انتخاب کنید.

   این یک گردش کار هدایت شده را راه اندازی می کند که دو API را برای شما فعال می کند. این کنسول همچنین یک کلید API Gemini ایجاد می‌کند و همچنین Firebase AI Logic API را به لیست مجاز برای کلید Firebase API شما اضافه می‌کند.

کدام مدل ها را می توان با Firebase AI Logic SDK استفاده کرد؟

• می‌توانید از هر یک از مدل‌های پایه Gemini و Imagen 3 با Firebase AI Logic SDK، از جمله نسخه‌های پیش‌نمایش و آزمایشی استفاده کنید. فهرستی از این مدل‌ها را در اطلاعات مربوط به مدل‌های پشتیبانی شده ببینید.

• نمی‌توانید از مدل‌های Gemini بدون پایه (مانند مدل‌های PalM، مدل‌های تنظیم‌شده یا مدل‌های مبتنی بر Gemma) با Firebase AI Logic SDK استفاده کنید.

  Firebase AI Logic همچنین از مدل های قدیمی Imagen یا imagen-3.0-capability-001 پشتیبانی نمی کند.

• Gemini Developer API (صرف نظر از نحوه دسترسی) imagen-3.0-fast-generate-001 یا قدیمی تر imagen-3.0-generate-001 پشتیبانی نمی کند.

ما اغلب قابلیت‌های جدیدی را به SDK اضافه می‌کنیم، بنابراین برای به‌روزرسانی‌ها (و همچنین در یادداشت‌های انتشار، وبلاگ‌ها و پست‌های اجتماعی) دوباره به این سؤالات متداول مراجعه کنید.

وقتی مدل ها بازنشسته می شوند چه باید کرد؟

هنگامی که یک نسخه مدل پایدار را منتشر می کنیم، تلاش می کنیم اطمینان حاصل کنیم که حداقل یک سال در دسترس است. ما این "تاریخ بازنشستگی" را چندین مکان در اسناد Firebase و Google Cloud فهرست می کنیم (به عنوان مثال، در صفحه "مدل ها" ).

هنگامی که یک مدل بازنشسته می شود، هر درخواستی برای آن مدل با خطای 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

• مدل های فلش جمینی 1.5 :

  • gemini-1.5-flash-002 (و gemini-1.5-flash ): ۲۴ سپتامبر ۲۰۲۵
  • gemini-1.5-flash-001 : 24 مه 2025

• مدل‌های Gemini 1.0 Pro Vision : 21 آوریل 2025 (قبلاً برای 09 آوریل 2025 برنامه‌ریزی شده بود)

• مدل‌های Gemini 1.0 Pro : 21 آوریل 2025 (قبلاً برای 09 آوریل 2025 برنامه‌ریزی شده بود)

چگونه محدودیت نرخ هر کاربر را تعیین کنم؟

به طور پیش‌فرض، Firebase AI Logic محدودیت درخواست برای هر کاربر را 100 درخواست در دقیقه (RPM) تعیین می‌کند.

اگر می‌خواهید محدودیت نرخ هر کاربر خود را تنظیم کنید، باید تنظیمات سهمیه برای Firebase AI Logic API را تنظیم کنید.

درباره سهمیه Firebase AI Logic API بیشتر بیاموزید. در آن صفحه، می‌توانید نحوه مشاهده و ویرایش سهمیه خود را نیز بیاموزید.

کدام مجوزها برای استفاده از Firebase AI Logic SDK مورد نیاز است؟

آیا Firebase AI Logic از داده های من برای آموزش مدل ها استفاده می کند؟

به مدیریت داده و هوش مصنوعی مسئول مراجعه کنید.

آیا نوع MIME در درخواست های چندوجهی من مورد نیاز است؟ (مانند ورودی تصاویر، PDF، ویدیو و صدا)

بله، در هر درخواست چند وجهی، همیشه باید موارد زیر را ارائه دهید:

• mimeType فایل. یک استثنا را در زیر ببینید.

• فایل. می‌توانید فایل را به‌عنوان داده‌های درون خطی ارائه کنید یا فایل را با استفاده از URL آن ارائه کنید.

در مورد انواع فایل ورودی پشتیبانی شده، نحوه تعیین نوع MIME و دو گزینه برای ارائه فایل در فایل های ورودی پشتیبانی شده و الزامات اطلاعات کسب کنید.

استثنا برای گنجاندن نوع MIME در درخواست شما

یک استثنا برای ارائه نوع MIME، ورودی‌های تصویر درون خطی برای درخواست‌های برنامه‌های پلتفرم اندروید و اپل است.

Firebase AI Logic SDK برای پلتفرم‌های اندروید و اپل یک روش ساده و سازگار با پلتفرم برای رسیدگی به تصاویر در درخواست‌ها ارائه می‌کند - همه تصاویر (بدون توجه به فرمت آنها) قبل از ارسال به سرور، سمت مشتری با کیفیت 80 درصد به JPEG تبدیل می‌شوند. این بدان معناست که وقتی تصاویر را به‌عنوان داده‌های درون خطی با استفاده از SDK پلتفرم‌های Android و Apple ارائه می‌کنید، نیازی به تعیین نوع MIME در درخواست ندارید .

این مدیریت ساده در مستندات Firebase AI Logic در مثال‌هایی برای ارسال تصاویر کدگذاری شده با base64 در درخواست‌ها نشان داده شده است.

در اینجا برخی از اطلاعات اضافی پلتفرم خاص در مورد این ویژگی آمده است:

• برای اندروید :

  • می‌توانید از روش ساده‌شده برای مدیریت انواع تصاویر بومی پلتفرم ( Bitmap ) در اعلان‌های چندوجهی که حاوی تصاویر به‌عنوان داده‌های درون خطی هستند استفاده کنید (به مثال مراجعه کنید).

  • برای کنترل بیشتر بر روی فرمت‌ها و تبدیل‌های تصویر، می‌توانید تصاویر را به‌عنوان InlineDataPart ارائه کنید و نوع MIME خاصی را ارائه کنید. به عنوان مثال:

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

• برای پلتفرم های اپل :

  • می‌توانید از روش ساده‌شده برای مدیریت انواع تصاویر بومی پلتفرم ( UIImage ، NSImage ، CIImage ، و CGImage ) در اعلان‌های چندوجهی که حاوی تصاویر به‌عنوان داده‌های درون خطی هستند، استفاده کنید (به مثال مراجعه کنید).

  • برای کنترل بیشتر بر روی فرمت‌ها و تبدیل‌های تصویر، می‌توانید تصاویر را به‌عنوان InlineDataPart ارائه کنید و نوع MIME خاصی را ارائه کنید. به عنوان مثال:

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

آیا این ویژگی ها هنگام استفاده از Firebase AI Logic در دسترس هستند؟ ذخیره سازی متن، جستجو به عنوان یک ابزار، زمینه سازی با جستجوی گوگل، اجرای کد، تنظیم دقیق مدل، تولید جاسازی ها، و بازیابی معنایی؟

ذخیره‌سازی متن، جستجو به‌عنوان ابزار، زمین‌گذاری با جستجوی Google، اجرای کد، تنظیم دقیق مدل، تولید جاسازی‌ها و بازیابی معنایی توسط مدل‌های مختلف یا Vertex AI Gemini API پشتیبانی می‌شوند، اما هنگام استفاده از Firebase AI Logic در دسترس نیستند .

اگر می‌خواهید این موارد را به عنوان درخواست ویژگی اضافه کنید یا به درخواست ویژگی موجود رأی دهید، از Firebase UserVoice بازدید کنید.

کلید Gemini API چیست؟

Gemini Developer API از یک "کلید API Gemini " برای مجوز دادن به تماس گیرنده استفاده می کند. بنابراین، اگر از Gemini Developer API از طریق Firebase AI Logic SDK استفاده می‌کنید، برای برقراری تماس با آن API به یک کلید API معتبر Gemini در پروژه Firebase خود نیاز دارید.

یک "کلید API Gemini " فقط به معنای کلید API است که API توسعه دهنده Gemini را در لیست مجاز API خود دارد.

هنگامی که گردش کار راه اندازی Firebase AI Logic را در کنسول Firebase انجام می دهید، یک کلید API Gemini ایجاد می کنیم که فقط به Gemini Developer API محدود می شود و سرویس پروکسی Firebase AI Logic را برای استفاده از این کلید API راه اندازی می کنیم. این کلید Gemini API ایجاد شده توسط Firebase در صفحه اطلاعات کاربری کنسول Google Cloud به نام کلید API توسعه دهنده Gemini (به طور خودکار توسط Firebase ایجاد شده است) .

درباره محدودیت‌های API برای کلیدهای API بیشتر بدانید.

هنگام استفاده از Firebase AI Logic SDK، کلید API Gemini خود را به پایگاه کد برنامه خود اضافه نمی کنید. درباره نحوه ایمن نگه داشتن کلید Gemini API بیشتر بیاموزید.

آیا باید کلید Gemini API خود را به پایگاه کد تلفن همراه یا برنامه وب خود اضافه کنم؟

هنگام استفاده از Firebase AI Logic SDK، کلید Gemini API خود را به پایگاه کد برنامه خود اضافه نکنید .

در واقع، هنگام توسعه با Firebase AI Logic SDK، شما مستقیماً با کلید Gemini API خود تعامل ندارید. در عوض، سرویس پروکسی Firebase AI Logic ما به صورت داخلی کلید Gemini API را در هر درخواست به Gemini Developer API - کاملاً در باطن، شامل می‌شود.

چگونه می توانم کلید Gemini API مورد استفاده برای فراخوانی Gemini Developer API را تغییر دهم؟

هنگام استفاده از Firebase AI Logic SDK، بعید است که نیاز به تغییر کلید Gemini API خود داشته باشید. با این حال، در اینجا دو مورد وجود دارد که ممکن است لازم باشد:

• اگر به طور تصادفی کلید لو رفت و می خواهید آن را با یک کلید امن جدید جایگزین کنید.

• اگر به طور تصادفی کلید را حذف کردید. توجه داشته باشید که می توانید کلید را ظرف 30 روز پس از حذف حذف کنید .

در اینجا نحوه تغییر کلید Gemini API که توسط Firebase AI Logic SDK استفاده می شود، آمده است:

1. اگر کلید Gemini API ایجاد شده توسط Firebase هنوز وجود دارد، آن را حذف کنید.

   می‌توانید این کلید API را در APIs & Services > Panel Credentials کنسول Google Cloud حذف کنید. نام دارد:
   کلید API توسعه دهنده Gemini (به طور خودکار توسط Firebase ایجاد شده است) .

2. در همان صفحه از کنسول Google Cloud ، یک کلید API جدید ایجاد کنید. پیشنهاد می کنیم نام آن را به این صورت نامگذاری کنید:
   کلید API توسعه دهنده Gemini برای Firebase .

3. به این کلید API جدید، محدودیت‌های API را اضافه کنید و فقط Generative Language API را انتخاب کنید.
   «API زبان مولد» چیزی است که گاهی اوقات در کنسول Google Cloud به Gemini Developer API گفته می شود.

   هیچ محدودیتی برای برنامه اضافه نکنید . در غیر این صورت سرویس پروکسی Firebase AI Logic آنطور که انتظار می رود کار نخواهد کرد.

4. برای تنظیم این کلید جدید به عنوان کلید Gemini API که سرویس پروکسی 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 بیاموزید.

مطمئن شوید که این کلید API جدید Gemini را به پایگاه کد برنامه خود اضافه نکنید . درباره نحوه ایمن نگه داشتن کلید Gemini API بیشتر بیاموزید.

آیا می توانم از "کلید API Firebase" به عنوان کلید Gemini API خود استفاده کنم؟

نه - شما نباید از "کلید API Firebase" به عنوان کلید API Gemini خود استفاده کنید. اکیداً توصیه می کنیم که Gemini Developer API را به لیست مجاز برای کلید Firebase API خود اضافه نکنید .

کلید Firebase API شما کلید API است که در فایل پیکربندی Firebase یا شیء شما فهرست شده است که برای اتصال برنامه خود به Firebase به پایگاه کد برنامه خود اضافه می کنید. وقتی از کلید فقط با APIهای مرتبط با Firebase (مانند Firebase AI Logic ) استفاده می‌کنید، اشکالی ندارد که کلید API Firebase خود را در کد خود قرار دهید. اطلاعات مهم در مورد کلیدهای API Firebase بیاموزید .

در پنل APIs & Services > Credentials کنسول Google Cloud ، کلیدهای Firebase API به این صورت است:

از آنجا که برای کار کردن API های مرتبط با Firebase باید کلید Firebase API خود را به پایگاه کد برنامه خود اضافه کنید، و چون Gemini Developer API از طریق کلید API مجاز است، اکیداً توصیه می کنیم که Gemini Developer API (که در کنسول Google Cloud کنسول Google Cloud نامیده می شود) را به API API خود اضافه نکنید . اگر این کار را انجام دهید، API توسعه دهنده Gemini را در معرض سوء استفاده احتمالی قرار می دهید.

چگونه کلید Gemini API خود را ایمن نگه دارم؟

این پرسش‌های متداول برخی از بهترین روش‌های توصیه‌شده برای ایمن نگه‌داشتن کلید Gemini API را شرح می‌دهد.

اگر مستقیماً از تلفن همراه یا برنامه وب خود با Gemini Developer API تماس می گیرید:

• از Firebase AI Logic SDK مشتری استفاده کنید.
• کلید Gemini API خود را به پایگاه کد برنامه خود اضافه نکنید .

Firebase AI Logic یک سرویس پروکسی ارائه می دهد که به طور داخلی کلید Gemini API شما را در هر درخواست به Gemini Developer API - کاملاً در باطن، شامل می شود.

علاوه بر این، ما به شدت موارد زیر را توصیه می کنیم:

• به محض اینکه شروع به توسعه جدی برنامه خود کردید، با Firebase App Check یکپارچه شوید تا به محافظت از منابع پشتیبان خود و همچنین API های مورد استفاده برای دسترسی به مدل های تولیدی کمک کنید.

• از کلید API Gemini تولید شده توسط Firebase خارج از Firebase AI Logic استفاده مجدد نکنید . اگر برای استفاده دیگری به یک کلید API Gemini نیاز دارید، یک کلید جداگانه ایجاد کنید.

• به طور کلی، نباید کلید Gemini API ایجاد شده توسط Firebase را تغییر دهید. نام این کلید Gemini Developer API key (به طور خودکار توسط Firebase ایجاد شده) در کنسول Google Cloud است.

  • هیچ API اضافی را به لیست مجاز API برای کلید Gemini API ایجاد شده توسط Firebase اضافه نکنید . در لیست مجاز API، کلید Gemini API شما باید فقط دارای API توسعه دهنده Gemini باشد (که در کنسول Google Cloud "API زبان تولیدی" نامیده می شود).

  • هیچ محدودیتی برای برنامه اضافه نکنید . در غیر این صورت سرویس پروکسی Firebase AI Logic آنطور که انتظار می رود کار نخواهد کرد.

کلید Gemini API من به خطر افتاده است. چه کاری باید انجام دهم؟

اگر کلید Gemini API شما به خطر افتاده است، دستورالعمل‌ها را برای تغییر کلید Gemini API که برای فراخوانی Gemini Developer API استفاده می‌شود، دنبال کنید.

همچنین، بهترین روش های توصیه شده را برای ایمن نگه داشتن کلید 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 بروید. روی Get start کلیک کنید و سپس Gemini Developer API را انتخاب کنید. API را فعال کنید، کنسول پروژه شما را برای Gemini Developer API راه‌اندازی می‌کند. پس از تکمیل گردش کار، دوباره درخواست خود را امتحان کنید.

• اگر اخیراً گردش کار راه‌اندازی Firebase AI Logic را در کنسول Firebase انجام داده‌اید، ممکن است کلید Gemini API شما هنوز برای همه خدمات پشتیبانی مورد نیاز در همه مناطق در دسترس نباشد.

  چه باید کرد:
  چند دقیقه صبر کنید و سپس دوباره درخواست خود را امتحان کنید.

• ممکن است کلید Gemini API شما از پروژه Firebase شما حذف شده باشد.

  چه باید کرد:
  با نحوه تغییر کلید Gemini API استفاده شده توسط Firebase AI Logic آشنا شوید.

چگونه این خطای 400 را برطرف کنم؟ Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

اگر می‌خواهید یک درخواست چندوجهی با یک Cloud Storage for Firebase ارسال کنید، ممکن است با خطای 400 زیر مواجه شوید:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

این خطا توسط پروژه ای ایجاد می شود که هنگام فعال شدن Vertex AI API در پروژه، عوامل خدمات مورد نیاز به طور خودکار به درستی ارائه نشده است. این یک مشکل شناخته شده در مورد برخی از پروژه ها است و ما در حال کار بر روی یک تعمیر جهانی هستیم.

در اینجا راه حلی برای تعمیر پروژه و ارائه صحیح این عوامل خدماتی وجود دارد تا بتوانید در درخواست های چندوجهی خود Cloud Storage for Firebase وارد کنید. شما باید مالک پروژه باشید و فقط باید یک بار این مجموعه از وظایف را برای پروژه خود تکمیل کنید.

1. دسترسی و احراز هویت با gcloud CLI .
   ساده ترین راه برای انجام این کار از Cloud Shell است. در اسناد Google Cloud بیشتر بیاموزید.

2. اگر از شما خواسته شد، دستورالعمل‌های نمایش داده شده در ترمینال را دنبال کنید تا gcloud CLI در برابر پروژه Firebase شما اجرا شود.

   شما به ID پروژه 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. چند دقیقه صبر کنید تا مطمئن شوید که عوامل سرویس ارائه شده اند، و سپس دوباره درخواست چندوجهی خود را که شامل Cloud Storage for Firebase URL است ارسال کنید.

اگر پس از چند دقیقه انتظار همچنان این خطا را دریافت می‌کنید، با پشتیبانی Firebase تماس بگیرید.

چگونه این خطای 400 را برطرف کنم؟ API key not valid. Please pass a valid API key.

اگر یک خطای 400 دریافت کردید که می گوید API key not valid. Please pass a valid API key. ، معمولاً به این معنی است که کلید API در فایل/شیء پیکربندی Firebase شما وجود ندارد یا برای استفاده با برنامه و/یا پروژه Firebase شما تنظیم نشده است.

بررسی کنید که کلید API فهرست شده در فایل/شیء پیکربندی Firebase با کلید API برنامه شما مطابقت داشته باشد. می‌توانید همه کلیدهای API خود را در APIs & Services > پنل اعتبارنامه‌ها در کنسول Google Cloud مشاهده کنید.

اگر متوجه شدید که آنها مطابقت ندارند، یک فایل/شیء پیکربندی Firebase جدید تهیه کنید و سپس آن را جایگزین کنید که در برنامه شما است. فایل/شیء پیکربندی تازه باید حاوی یک کلید API معتبر برای برنامه و پروژه Firebase شما باشد.

چگونه این خطای 403 را برطرف کنم؟ Requests to this API firebasevertexai.googleapis.com ... are blocked.

اگر یک خطای 403 دریافت کردید که می‌گوید Requests to this API firebasevertexai.googleapis.com ... are blocked. ، معمولاً به این معنی است که کلید API در فایل/شیء پیکربندی Firebase شما یک API مورد نیاز را در لیست مجاز خود برای محصولی که می‌خواهید استفاده کنید ندارد.

مطمئن شوید که کلید API مورد استفاده برنامه شما دارای همه APIهای مورد نیاز موجود در فهرست مجاز "محدودیت های API" کلید است . برای Firebase AI Logic ، کلید API شما باید حداقل Firebase AI Logic API را در لیست مجاز خود داشته باشد.

می‌توانید همه کلیدهای API خود را در APIs & Services > پنل اعتبارنامه‌ها در کنسول Google Cloud مشاهده کنید.

چگونه این خطای 403 را برطرف کنم؟ PERMISSION_DENIED: The caller does not have permission.

اگر یک خطای 403 دریافت کردید که می گوید PERMISSION_DENIED: The caller does not have permission. ، معمولاً به این معنی است که کلید API در فایل/شیء پیکربندی Firebase شما متعلق به پروژه Firebase دیگری است.

بررسی کنید که کلید API فهرست شده در فایل/شیء پیکربندی Firebase با کلید API برنامه شما مطابقت داشته باشد. می‌توانید همه کلیدهای API خود را در APIs & Services > پنل اعتبارنامه‌ها در کنسول Google Cloud مشاهده کنید.

اگر متوجه شدید که آنها مطابقت ندارند، یک فایل/شیء پیکربندی Firebase جدید تهیه کنید و سپس آن را جایگزین کنید که در برنامه شما است. فایل/شیء پیکربندی تازه باید حاوی یک کلید API معتبر برای برنامه و پروژه Firebase شما باشد.