ציון המיקום שאליו צריך לגשת כדי לגשת למודל

כדי לראות תוכן וקוד שספציפיים לספק, לוחצים על הספק Gemini API בדף הזה.


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

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

  • כשמשתמשים בתחביר החדש של "פלטפורמת הסוכנים" לאתחול: global
  • כשמשתמשים בתחביר הקודם של Vertex AI: us-central1

מידע על המיקום של global

כמעט לכל המודלים של Gemini, ב-Agent Platform Gemini API (formerly Vertex AI) יש מיקום global, כלומר הבקשה תטופל על ידי מודל זמין בכל מקום במאגר הגלובלי.

אם תשתמשו במיקום global לבקשות שלכם, תוכלו להימנע מלהגיע למגבלות הקיבולת של המודל ולצמצם את השגיאות מסוג "השירות עמוס" (503). בנוסף, בהתאם למודל, יכול להיות שתצטרכו להשתמש במיקום global כי זה המיקום היחיד שזמין למודל (לדוגמה, מודל Gemini בגרסת טרום-השקה (Preview)).

מתי צריך להגדיר מיקום באופן מפורש?

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

בדגמים מסוימים חובה להגדיר מיקום באופן מפורש. אם תנסו לגשת למודל במיקום שבו הוא לא זמין, תקבלו את השגיאה 404 עם ההודעה was not found or your project does not have access to it.

  • מודלים בגרסאות Gemini טרום-השקה (Preview) וניסיוניות: זמינים רק במיקום global.

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

  • מודלים של Gemini 2.5: זמינים בהרבה מיקומים. שימו לב שהמודלים של Gemini Live API 2.5 לא זמינים ב-global.

בהמשך הדף מופיעה רשימה של כל המיקומים הזמינים.

עובדות כלליות ושיטות מומלצות

ריכזנו כאן כמה עובדות חשובות ושיטות מומלצות לגבי מיקומים:

  • מגבלות הקיבולת הן לכל מודל, לכל אזור ולכל דקה.

  • כדי להימנע מחריגה בלתי צפויה ממגבלות הקיבולת, כדאי להשתמש במיקום global (אם המודל זמין במיקום global).

  • כדאי להשתמש ב-Firebase Remote Config כדי לשלוט במיקום שממנו אתם ניגשים למודל. כך תוכלו לשנות את המיקום בלי לפרסם גרסה חדשה של האפליקציה.

  • אם המיקום global לא מתאים לתרחיש לדוגמה שלכם, כדאי להגדיר במפורש את המיקום שבו אתם ניגשים למודל (אם המודל זמין במיקומים אחרים מלבד global). לדוגמה, אתם יכולים להגדיר את המיקום על סמך המיקום של משתמש הקצה באמצעות Firebase Remote Config.

דוגמאות קוד

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

מחליפים את LOCATION בקוד המיקום (לדוגמה, global או us-central1) מתוך רשימת המיקומים הזמינים שמופיעה בהמשך הדף.

התחביר של Agent Platform

Swift

התחביר של agentPlatform זמין החל מגרסה 12.17.0 ואילך של ה-SDK.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))

// ...

Kotlin

התחביר של agentPlatform זמין החל מגרסה 17.15.0 ואילך של ה-SDK ומגרסה 34.17.0 ואילך של Firebase Android BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))

// ...

Java

התחביר של agentPlatform זמין החל מגרסה 17.15.0 ואילך של ה-SDK ומגרסה 34.17.0 ואילך של Firebase Android BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));

// ...

Web

התחביר AgentPlatformBackend זמין החל מגרסה 12.17.0 ואילך של ה-SDK.

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });

// ...

Dart

התחביר של agentPlatform זמין החל מגרסה 3.15.0 של הפלאגין ומגרסה 4.18.0 של Firebase Flutter BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');

// ...

Unity

התחביר AgentPlatform זמין החל מגרסה 13.15.0 של ה-SDK.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));

// ...

תחביר של Vertex AI

Swift

התחביר vertexAI הוסר בגרסה 13.0.0 של ה-SDK.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// ...

Kotlin

התחביר vertexAI הוסר בגרסה 18.0.0 של ה-SDK ובגרסה 35.0.0 של Firebase Android BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

Java

התחביר vertexAI הוסר בגרסה 18.0.0 של ה-SDK ובגרסה 35.0.0 של Firebase Android BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

Web

התחביר VertexAIBackend הוסר בגרסה 13.0.0 של ה-SDK.

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

Dart

התחביר vertexAI הוסר בגרסה 5.0.0 של הפלאגין ובגרסה 5.0.0 של Firebase Flutter BoM.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

Unity

התחביר VertexAI הוסר בגרסה 14.0.0 של ה-SDK.

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// ...

שימו לב: אם תציינו מיקום שבו המודל לא זמין, תקבלו את השגיאה 404 עם ההודעה was not found or your project does not have access to it.

מיקומים זמינים

ב-Google Cloud משתמשים באזורים. ‫Google Cloud מאחסן את נתוני הלקוחות רק באזור שציינתם לכל התכונות של בינה מלאכותית גנרטיבית שזמינות לכלל המשתמשים ב-Agent Platform.

אפשר להשתמש ב-AI גנרטיבי ב-Agent Platform באזורים הבאים. יכול להיות שחלק מהמודלים או גרסאות ספציפיות לא יהיו זמינים בכל המיקומים (למידע מפורט על הזמינות במיקומים, עיינו במסמכי התיעוד של Google Cloud).

שימו לב לנקודות הבאות:

  • Firebase AI Logic מוגדר כברירת מחדל למיקומים הבאים:

    • כשמשתמשים בתחביר החדש של "פלטפורמת הסוכנים" לאתחול: global
    • כשמשתמשים בתחביר הקודם של Vertex AI: us-central1

  • מודלים בגרסת Gemini טרום-השקה (Preview) וניסיוניים: זמינים רק במיקום global.

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

  • מודלים של Gemini 2.5: זמינים בהרבה מיקומים. שימו לב שהמודלים של Gemini Live API 2.5 לא זמינים ב-global.

‫Gemini 3.x ודגמים חדשים יותר

כשמשתמשים במודלים מגרסה Gemini 3.x ואילך, Firebase AI Logic תומך במיקומים הבאים:

  • global
  • us
  • eu

לפרטים על המיקומים הזמינים לכל מודל, עיינו במאמרי העזרה בנושא Google Cloud.

מודלים מדורות קודמים

כשמשתמשים במודלים ישנים יותר של Gemini (כמו מודלים בגרסה 2.5), Firebase AI Logic תומך במיקומים הבאים:

גלובלי

  • global

ארצות הברית

  • קולומבוס, אוהיו (us-east5)
  • דאלאס, טקסס (us-south1)
  • איווה (us-central1)
  • לאס וגאס, נבדה (us-west4)
  • מונקס קורנר, קרוליינה הדרומית (us-east1)
  • צפון וירג'יניה (us-east4)
  • אורגון (us-west1)

קנדה

  • מונטריאול (northamerica-northeast1)

דרום אמריקה

  • סאו פאולו, ברזיל (southamerica-east1)

אירופה

  • בלגיה (europe-west1)
  • פינלנד (europe-north1)
  • פרנקפורט, גרמניה (europe-west3)
  • לונדון, בריטניה (europe-west2)
  • מדריד, ספרד (europe-southwest1)
  • מילאנו, איטליה (europe-west8)
  • הולנד (europe-west4)
  • פריז, צרפת (europe-west9)
  • ורשה, פולין (europe-central2)
  • ציריך, שווייץ (europe-west6)

אסיה ואזור האוקיינוס השקט

  • מחוז צ'אנגחואה, טייוואן (asia-east1)
  • הונג קונג, סין (asia-east2)
  • מומבאי, הודו (asia-south1)
  • סיאול, קוריאה (asia-northeast3)
  • סינגפור (asia-southeast1)
  • סידני, אוסטרליה (australia-southeast1)
  • טוקיו, יפן (asia-northeast1)

המזרח התיכון

  • דמאם, ערב הסעודית (me-central2)
  • דוחא, קטאר (me-central1)
  • תל אביב, ישראל (me-west1)

שימו לב שהמודלים של Gemini Live API 2.5 לא זמינים ב-global.

לפרטים על המיקומים הזמינים לכל מודל, עיינו במאמרי העזרה בנושא Google Cloud.

רשימה של מיקומים שהיו זמינים בעבר, אבל עכשיו הם לא זמינים:

  • עדיין לא נדחו מיקומים