קודי שגיאה

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

השגיאה הזו נגרמת בגלל פרויקט שסוכני השירות הנדרשים שלו לא הוקצו אוטומטית בצורה נכונה כשממשק 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: 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

אם מופיעה שגיאת 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 Pro שם הדגם: gemini-3.1-pro-preview (זמין רק בתצוגה מקדימה)
    • הגרסה העדכנית של Gemini 3.x Flash שם הדגם: gemini-3.6-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 models: זמינים בהרבה מיקומים.

    • מודלים של 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 או ב-Agent Platform Gemini API (formerly Vertex AI). מידע נוסף על מכסות ועל בקשת מכסות נוספות זמין במאמר מגבלות קצב ומכסות.

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