קודי שגיאה

שגיאה 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.

אם אתם מנסים לשלוח בקשה מולטימודלית עם Cloud Storage for Firebase כתובת URL, יכול להיות שתיתקלו בשגיאת 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 כך שיכללו את ה-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, עוברים לדף Firebase AI Logic. לוחצים על שנתחיל? ובוחרים באפשרות Gemini Developer API. מפעילים את ה-API, והמסוף יגדיר את הפרויקט ל-Gemini Developer API. אחרי השלמת תהליך העבודה, כדאי לנסות לשלוח את הבקשה שוב.

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

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

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

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

שגיאה 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.1 Pro הוא gemini-3.1-pro-preview.
    • השם של המודל לתצוגה מקדימה Gemini 3 Flash הוא gemini-3-flash-preview.
    • השם של מודל התצוגה המקדימה Nano Banana Pro הוא gemini-3-pro-image-preview.
    • שם מודל התצוגה המקדימה של Nano Banana 2 הוא gemini-3.1-flash-image-preview.
    • שם המודל Nano Banana הוא gemini-2.5-flash-image.

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

  • הסיבה: אתם משתמשים בגרסת תצוגה מקדימה או בגרסה ניסיונית של מודל (למשל, gemini-3.1-pro-preview ו-gemini-3.1-flash-image-preview), ולא ציינתם את globalהמיקום.

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

  • תיקון: כשמפעילים את שירות Vertex AI Gemini API, צריך לציין את המיקום global. איך מציינים את המיקום לגישה למודל (כולל קטעי קוד)

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

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

    אם אתם משתמשים ב-Vertex AI Gemini API, חלק מהמודלים זמינים רק במיקומים ספציפיים. לדוגמה (רשימה חלקית):

    • מודלים של Imagen לא נתמכים במיקום global.
    • מודלים של Gemini Live API (כמו gemini-2.0-flash-live-preview-04-09) נתמכים רק במיקום us-central1.
    • מודלים של Gemini 2.5 (כמו gemini-2.5-pro) זמינים רק במיקום global, במיקומים בארה"ב ובמיקומים מסוימים באירופה (ולפעמים במיקומים אחרים אם יש לפרויקט שלכם אפשרויות מיוחדות).

  • תיקון: כשמפעילים את השירות Vertex AI Gemini API, צריך לוודא שמציינים מיקום נתמך עבור המודל שבו משתמשים. איך מציינים את המיקום לגישה למודל (כולל קטעי קוד) ואילו מיקומים נתמכים למודלים

    שימו לב: Firebase AI Logic מוגדר כברירת מחדל למיקום us-central1.

שגיאות 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.