קודי שגיאה

שגיאה 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 Check ועדיין מופיעה השגיאה הזו, בדקו אם הגנה מפני שידור חוזר מופעלת עבור Firebase AI Logic (כולל במצב 'מעקב בלבד').

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

4. לפני שמפרסמים את האפליקציה למשתמשי הקצה, צריך להגדיר ספק אימות בסביבת הייצור (כמו 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) > AI Logic (לוגיקת AI). לוחצים על 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.8-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 מודלים בגרסת טרום-השקה וניסיוניים: זמינים רק במיקום global.

    • Gemini 3.x מודלים יציבים: זמינים במיקום global ולעתים קרובות גם במיקומים us ו-eu.

    • מודלים של Gemini 2.5: זמינים בהרבה מיקומים. שימו לב: מודלים של Gemini Live API 2.5 לא זמינים ב-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 במאמרי העזרה בנושא תמחור ובשאלות הנפוצות בנושא חיוב.