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

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


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

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

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

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

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

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

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

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

  • מודלים יציבים של 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 

// ...

// 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 

// ...

// 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 

// ...

// 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 

// ...

// 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 

// ...

// 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 

// ...

// 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 

// ...

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

// ...

Kotlin 

// ...

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

// ...

Java 

// ...

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

// ...

Web 

// ...

// Initialize FirebaseApp

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

// ...

Dart 

// ...

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

// ...

Unity 

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
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 מאחסנת נתוני לקוחות רק באזור שאתם מציינים לכל התכונות הזמינות בדרך כלל של AI גנרטיבי ב-Agent Platform.

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

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

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

‫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)

המזרח התיכון

  • Dammam, Saudi Arabia (me-central2)
  • דוחה, קטאר (me-central1)
  • תל אביב, ישראל (me-west1)

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

פרטים על המיקומים שבהם זמין כל מודל מופיעים במסמכי התיעוד של Google Cloud.

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

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