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

מודלים גנרטיביים של AI מבית Google זמינים באזורים מסוימים.

כשמפעילים את שירות ה-backend‏ Vertex AI Gemini API בקוד, אפשר לציין את המיקום של המודל שאליו ניגשים בבקשות. בהמשך הדף מופיעה רשימה של מיקומים זמינים.

כדי לגשת לרוב המודלים של Gemini, המערכת תומכת במיקום global, כלומר הבקשה שלכם תטופל על ידי מודל זמין מכל מקום במאגר הגלובלי. הגדרת המיקום ל-global בבקשות יכולה לעזור לכם להימנע מהגעה למגבלות הקיבולת של המודל ומהפחתה של שגיאות מסוג 'השירות עמוס מדי' (503).Vertex AI Gemini API

בהתאם למודל, יכול להיות שתידרש הגדרה של המיקום הזה:

• Gemini preview models: חובה להגדיר את המיקום ל-global (למעט מודלים של Live API בתצוגה מקדימה).

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

• מודלים של Gemini 2.5: הגדרת המיקום היא אופציונלית. אם לא מציינים מיקום, ברירת המחדל היא us-central1.

• מודלים של Gemini Live API: הגדרת המיקום היא אופציונלית. אם לא מציינים מיקום, ברירת המחדל היא us-central1. שימו לב שהמיקום global לא נתמך.

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

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

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

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

דוגמאות קוד

שימו לב שהדוגמאות האלה מראות גישה למודל Gemini, אבל אפשר גם לציין מיקום כשניגשים למודל Imagen.

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

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// Create a `GenerativeModel` instance with a model that supports your use case
let model = ai.generativeModel(modelName: "MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
val model = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
                        .generativeModel("MODEL_NAME")

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"))
        .generativeModel("MODEL_NAME");

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

// ...

// Initialize FirebaseApp
const firebaseApp = initializeApp(firebaseConfig);

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// Create a `GenerativeModel` instance with a model that supports your use case
const model = getGenerativeModel(ai, { model: 'MODEL_NAME' });

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// Create a `GenerativeModel` instance with a model that supports your use case
final model = ai.generativeModel(model: 'MODEL_NAME');

// ...

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify a supported location for where you want to access the model
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));

// Create a `GenerativeModel` instance with a model that supports your use case
var model = ai.GetGenerativeModel(modelName: "MODEL_NAME");

// ...

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

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

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

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

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

• בכל המודלים Gemini בגרסת טרום-השקה (מלבד מודלים של Live API), המיקום הנתמך היחיד הוא global.

• כשמשתמשים ב-Firebase AI Logic כדי לגשת למודלים של Gemini 3.x, המיקום הנתמך היחיד הוא global.

• בכל דגמי Live API ובכל דגמי Imagen, המיקום global לא נתמך.