קודי שגיאה

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

השגיאה הזו נגרמת בגלל פרויקט שסוכני השירות הנדרשים שלו לא הוקצו אוטומטית בצורה נכונה כשממשק Agent Platform 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: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

אם קיבלתם שגיאה 403 - PERMISSION_DENIED עם הכיתוב To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, המשמעות היא שבבקשה שלכם אין טוקן App Check תקין, ואתם מנסים לגשת למודל שנעשה בו שימוש לרעה בדרך כלל.

זוהו מודלים גנרטיביים מסוימים שגורמים זדוניים נוהגים לנצל לרעה.

מכיוון שלא הפעלת את App Check עבור Firebase AI Logic, הפרויקט שלך חשוף לניצול לרעה של המודלים האלה. כדי להגן על המפתחים שלנו, Firebase חוסם את הגישה למודלים האלה אלא אם הבקשה כוללת טוקן App Check תקין (כלומר, App Check נאכף עבור Firebase AI Logic).

כדי לגשת למודל שהחזיר את השגיאה, צריך לבצע את הפעולות הבאות:

1. הגדרה של App Check עבור Firebase AI Logic לפיתוח מקומי, חשוב להגדיר את App Check ספק ניפוי הבאגים.

   אכיפת App Check היא קריטית להגנה על המודלים של Gemini API ושל Gemini מפני שימוש לרעה, והיא נדרשת כדי לפתור את השגיאה הזו.

2. שליחה מחדש של הבקשה מהאפליקציה אל Firebase AI Logic.

   הבקשה הזו תשלח עם טוקן App Check תקין, ולא תקבלו יותר את השגיאה 403 - PERMISSION_DENIED.

3. לפני שמשחררים את האפליקציה למשתמשי הקצה, צריך להגדיר ספק אימות ייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise) כדי שמשתמשי הקצה יוכלו לגשת לתכונת ה-AI כשתהליך App Check ייאכף.

שגיאה 403: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check

אם מופיעה השגיאה 403 - PERMISSION_DENIED עם הכיתוב Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check, סימן שהפרויקט שלכם ב-Firebase זוהה כלא פעיל ולא הופעל בו App Check עבור Firebase AI Logic.

'פרויקטים לא פעילים' הם פרויקטים שבהם Firebase AI Logic מופעל, אבל לא נעשה בהם שימוש לאחרונה ב-Firebase AI Logic.

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

כשרוצים לחזור להשתמש ב-Firebase AI Logic, צריך לבצע את הפעולות הבאות:

1. הגדרה של App Check עבור Firebase AI Logic לפיתוח מקומי, חשוב להגדיר את App Check ספק ניפוי הבאגים.

   אכיפת App Check היא קריטית להגנה על המודלים של Gemini API ושל Gemini מפני שימוש לרעה, והיא נדרשת כדי לפתור את השגיאה הזו.

2. שליחה מחדש של הבקשה מהאפליקציה אל Firebase AI Logic.

   הבקשה הזו תשלח עם טוקן App Check תקין, ולא תקבלו יותר את השגיאה 403 - PERMISSION_DENIED.

3. לפני שמשחררים את האפליקציה למשתמשי הקצה, צריך להגדיר ספק אימות ייצור (כמו App Attest,‏ Play Integrity או reCAPTCHA Enterprise) כדי שמשתמשי הקצה יוכלו לגשת לתכונת ה-AI כשתהליך App Check ייאכף.

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

שגיאה 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. לוחצים על שמירה.

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

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

אם מופיעה שגיאת 404 עם הכיתוב Firebase AI Logic genai config not found, בדרך כלל זה אומר שההגדרה של Firebase AI Logic שגויה או חסרה.

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

• עדיין לא הגדרתם את פרויקט Firebase שלכם לספק Gemini API.

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

• אם השלמתם לאחרונה את תהליך ההגדרה של Firebase AI Logic במסוף Firebase, יכול להיות שההגדרה של 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.1-pro-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 Progemini-3.1-pro-preview (זמין רק בגרסת טרום-השקה)
    • השם של הדגם העדכני ביותר: Gemini 3.x Flash gemini-3.7-flash
    • השם של הדגם העדכני ביותר: Gemini 3.x Flash‑Lite gemini-3.5-flash-lite
    • המודל העדכני ביותר של Gemini 3.x Pro Image (שנקרא גם Nano Banana Pro) שם המודל: gemini-3-pro-image
    • הגרסה העדכנית Gemini 3.x Flash Image (שנקראת גם Nano Banana 2) שם המודל: gemini-3.1-flash-image
    • הגרסה העדכנית Gemini 3.x Flash‑Lite Image (שנקראת גם Nano Banana 2 Lite) שם הדגם: gemini-3.1-flash-lite-image
    • הגרסה העדכנית של Gemini 2.5 Flash Image (שנקראת גם Nano Banana) שם המודל: gemini-2.5-flash-image

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

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

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

    כשמשתמשים בפונקציה Agent Platform Gemini API (formerly Vertex AI), אפשר לציין מיקום לגישה למודל במהלך האתחול. אם לא מציינים מיקום, Firebase AI Logic מוגדר כברירת מחדל למיקומים הבאים:

    • כשמשתמשים בתחביר לאתחול של Agent Platform: ‏ global
    • כשמשתמשים בתחביר ההפעלה מדור קודם של Vertex AI: ‏ us-central1

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

    • ‫Gemini מודלים בגרסת Preview וניסיוניים: זמינים רק במיקום global (למעט מודלים מסוג Live API – ראו בהמשך).

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

    • ‫Gemini 2.5 מודלים: זמינים בהרבה מיקומים.

    • ‫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."

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

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

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

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

• אתם מנסים להשתמש במודל או בתכונה שדורשים חיוב, אבל פרויקט Firebase שלכם מוגדר בתוכנית התמחור Spark.

  אם אתם משתמשים ב-Gemini Developer API, אתם יכולים לקבל גישה מוגבלת למודלים מסוימים ולגישה לתכונות בסיסיות רבות במסגרת Gemini Developer API 'התוכנית בחינם'. בתוכנית הזו אפשר להתחיל בלי לספק אמצעי תשלום, כלומר לא צריך לשדרג את פרויקט Firebase למינוי Blaze בתשלום לפי שימוש.

  • חלק מהמודלים לא זמינים בGemini Developer API"תוכנית בחינם" ודורשים את "רמת השימוש בתשלום". כלומר, הפרויקט שלכם צריך להיות במינוי Blaze בתשלום לפי שימוש. לדוגמה, כמעט תמיד נדרש חיוב עבור המודלים הבאים:

    • רוב המודלים בגרסת טרום-השקה ובגרסה ניסיונית
    • מודלים ליצירת תמונות (מודלים של Nano Banana)

  • חלק מהמודלים מציעים תכונות בסיסיות במסגרת Gemini Developer API 'התוכנית החינמית', אבל כדי להשתמש בתכונות מתקדמות יותר צריך לעבור ל'תוכנית בתשלום'. לדוגמה:

    • כדי להשתמש ברוב המודלים של Gemini 3.x, צריך להגדיר חיוב עבור Google Search או Google Maps.

  מידע נוסף על תוכניות התמחור של Firebase ועל Gemini Developer API

  פרטים נוספים זמינים Gemini Developer API במאמרי העזרה בנושא תמחור ובשאלות הנפוצות בנושא חיוב.