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

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


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

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

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

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

  • אם לא מציינים מיקום, ברירת המחדל היא us-central1.

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

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

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

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

דוגמאות קוד

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

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

Swift

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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")

// ...

Kotlin

// ...

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

// ...

Java

// ...

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

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

Web

// ...

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

// Initialize the Vertex AI Gemini API backend service
// Specify the 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' });

// ...

Dart

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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');

// ...

Unity

// ...

// Initialize the Vertex AI Gemini API backend service
// Specify the 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 (למעט המודלים של Gemini Live) זמינים גם במיקום global. במודלים של Imagen, אין תמיכה במיקום 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)