קודי שגיאה

שגיאה 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 > Credentials במסוף Google Cloud.

אם מגלים שהם לא זהים, צריך לקבל קובץ או אובייקט חדש של הגדרות Firebase ואז להחליף את הקובץ או האובייקט שקיימים באפליקציה. קובץ או אובייקט ההגדרות החדש צריכים לכלול מפתח API תקין לאפליקציה ולפרויקט Firebase.

שגיאה 400: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

אם אתם מנסים לשלוח בקשה מולטימודלית עם כתובת URL‏ Cloud Storage for Firebase יכול להיות שתיתקלו בשגיאה 400 הבאה:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

השגיאה הזו נגרמת בגלל פרויקט שסוכני השירות הנדרשים שלו לא הוקצו אוטומטית בצורה נכונה כשממשק Vertex AI API הופעל בפרויקט. זו בעיה מוכרת בחלק מהפרויקטים, ואנחנו פועלים כדי לפתור אותה באופן גלובלי.

כדי לתקן את הפרויקט ולהקצות את סוכני השירות האלה בצורה נכונה, כדי שתוכלו להתחיל לכלול כתובות URL של Cloud Storage for Firebase בבקשות הרב-מודאליות שלכם, אתם יכולים להשתמש בפתרון העקיף הבא. צריכה להיות לכם הרשאה של בעלים בפרויקט, ותצטרכו להשלים את המשימות האלה רק פעם אחת עבור הפרויקט.

1. ניגשים אל gcloud CLI ומבצעים אימות.
   הדרך הקלה ביותר לעשות זאת היא מ-Cloud Shell. מידע נוסף זמין בGoogle Cloudמאמרי העזרה.

2. אם תתבקשו, תצטרכו לפעול לפי ההוראות שמוצגות במסוף כדי להפעיל את gcloud CLI בפרויקט Firebase.

   תצטרכו את מזהה פרויקט Firebase, שאפשר למצוא בראש הדף settings Project 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.

שגיאה 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

אם מוצגת שגיאת 403 עם ההודעה Requests to this API firebasevertexai.googleapis.com ... are blocked., בדרך כלל המשמעות היא שמפתח ה-API בהגדרות Firebase באפליקציה כולל הגבלות שמונעות ממנו לקרוא ל-API הנדרש.

כדי לפתור את הבעיה, צריך לעדכן את ההגבלות של מפתח ה-API ב-Google Cloud Console כך שיכללו את ה-API הנדרש. במקרה של Firebase AI Logic, צריך לוודא ש-Firebase AI Logic API (firebasevertexai.googleapis.com) נכלל ברשימת ממשקי ה-API שנבחרו שאפשר לשלוח להם קריאות באמצעות מפתח ה-API.

כך עושים את זה:

1. במסוף Google Cloud, פותחים את החלונית APIs & Services > Credentials.

2. בוחרים את מפתח ה-API שהאפליקציה מוגדרת להשתמש בו (לדוגמה, 'מפתח iOS' לאפליקציה ל-iOS).

3. בדף Edit API key, מחפשים את הקטע API restrictions.

4. מוודאים שהאפשרות הגבלת המפתח מסומנת. אם לא, המפתח שלכם לא מוגבל, וכנראה שזה לא מקור השגיאה.

5. בתפריט הנפתח Selected APIs (ממשקי API נבחרים), מחפשים את Firebase AI Logic API ובוחרים אותו כדי להוסיף אותו לרשימה של ממשקי API נבחרים שאפשר להפעיל באמצעות מפתח ה-API.

6. לוחצים על שמירה.

   יכול להיות שיחלפו עד חמש דקות לפני שהשינויים ייכנסו לתוקף.

שגיאה 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 > Credentials במסוף Google Cloud.

אם מגלים שהם לא זהים, צריך לקבל קובץ או אובייקט חדש של הגדרות Firebase ואז להחליף את הקובץ או האובייקט שקיימים באפליקציה. קובץ או אובייקט ההגדרות החדש צריכים לכלול מפתח API תקין לאפליקציה ולפרויקט Firebase.

שגיאת 404: Firebase AI Logic genai config not found

אם אתם מנסים להשתמש ב-Gemini Developer API ומופיעה שגיאה 404 עם הכיתוב Firebase AI Logic genai config not found, בדרך כלל המשמעות היא שלפרויקט Firebase שלכם אין מפתח API תקין של Gemini לשימוש עם ערכות ה-SDK של הלקוח Firebase AI Logic.

אלה הסיבות הסבירות ביותר לשגיאה הזו:

• עדיין לא הגדרת את פרויקט Firebase עבור Gemini Developer API.

  מה עושים:
  במסוף Firebase, עוברים אל AI Services > AI Logic. לוחצים על שנתחיל? ובוחרים באפשרות Gemini Developer API. מפעילים את ה-API, והמסוף יגדיר את הפרויקט לשימוש ב-Gemini Developer API. אחרי השלמת תהליך העבודה, נסו לשלוח שוב את הבקשה.

• אם השלמתם לאחרונה את Firebase AI Logicתהליך ההגדרה במסוף Firebase, יכול להיות שמפתח ה-API של Gemini עדיין לא זמין לכל שירותי הקצה העורפי הנדרשים בכל האזורים.

  מה עושים:
  מחכים כמה דקות ומנסים שוב לשלוח את הבקשה.

• יכול להיות שמפתח ה-API מספר Gemini נמחק מהפרויקט ב-Firebase.

  מה עושים:
  כאן מוסבר איך לשנות את מפתח ה-API של Firebase AI LogicGemini.

שגיאה 404: המודל 'was not found or your project does not have access to it'?

לדוגמה: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3-pro-image-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."

יכולות להיות כמה סיבות לשגיאה כזו.

• שם דגם לא תקין

  • הגורם: שם הדגם שציינתם לא תקין.

  • פתרון: בודקים את שם המודל ואת גרסת המודל מול רשימת כל המודלים הנתמכים והזמינים. חשוב לבדוק את הפלחים ואת הסדר שלהם בשם המודל. לדוגמה:

    • שם הדגם העדכני ביותר של Gemini 3.x Pro: gemini-3.1-pro-preview (זמין רק בתצוגה מקדימה)
    • שם המודל העדכני של Gemini 3.x Flash: gemini-3.5-flash
    • שם המודל העדכני של Gemini 3.x Flash‑Lite: gemini-3.1-flash-lite
    • השם של מודל Gemini 3.x Pro Image העדכני (שנקרא גם Nano Banana Pro): gemini-3-pro-image-preview (זמין רק בתצוגה מקדימה)
    • השם של המודל העדכני של Gemini 3.x Flash Image (שנקרא גם Nano Banana 2): gemini-3.1-flash-image-preview (זמין רק בתצוגה מקדימה)
    • השם של המודל העדכני Nano Banana: gemini-2.5-flash-image

• מיקום לא תקין (רלוונטי רק אם משתמשים בספק Vertex AI Gemini API)

  • הסיבה: כל בקשה שמשתמשת ב-Vertex AI Gemini API צריכה לכלול את המיקום כדי לגשת למודל. יכול להיות שהבקשה שלך מנסה לגשת למודל במיקום שבו המודל לא זמין.

  • התיקון: מוודאים שהבקשה מנסה לגשת למודל שזמין.

    כשמשתמשים ב-Vertex AI Gemini API, ערך ברירת המחדל של Firebase AI Logic הוא us-central1. עם זאת, לא כל המודלים נתמכים ב-us-central1. כלומר, בהתאם למודל, יכול להיות שתצטרכו להגדיר במפורש מיקום ספציפי במהלך האתחול.

    • Gemini מודלים בגרסת טרום-השקה (preview) ומודלים ניסיוניים: חובה להגדיר את המיקום ל-global (למעט מודלים מסוג Live API). כל המודלים בגרסת טרום-השקה והניסיוניים של Gemini (חוץ ממודלים של Live API) זמינים רק במיקום global.

    • מודלים של Gemini 3.x: כשמשתמשים ב-Firebase AI Logic, צריך להגדיר את המיקום ל-global. ‫Firebase AI Logic עדיין לא תומך במיקומים us ו-eu.

    • מודלים של Gemini 2.5: הגדרת המיקום היא אופציונלית. אם לא מציינים מיקום, ברירת המחדל היא us-central1.

    • מודלים של Gemini Live API: הגדרת המיקום היא אופציונלית. אם לא מציינים מיקום, ברירת המחדל היא us-central1. שימו לב: אין תמיכה במיקום global.

  מידע נוסף על ציון המיקום לגישה למודל (כולל קטעי קוד)

שגיאות 429: "You exceeded your current quota, please check your plan and billing details" או "Resource exhausted, please try again later."

שגיאות 429 מציינות שחרגתם מהמכסה או שהמודל שאליו אתם ניגשים עמוס מדי בבקשות מאנשים אחרים.

הפעולה שצריך לבצע תלויה בשאלה אם אתם משתמשים ב-Gemini Developer API או ב-Vertex AI Gemini API. מידע נוסף על מכסות ועל בקשת מכסות נוספות זמין במאמר מגבלות קצב ומכסות.

אם אתם משתמשים ב-Vertex AI Gemini API, במסמכי התיעוד של Google Cloud יש הקשר נוסף והנחיות לגבי קוד השגיאה 429.