محل دسترسی به مدل را مشخص کنید

برای مشاهده محتوا و کد ارائه دهنده خاص در این صفحه، روی ارائه دهنده API Gemini خود کلیک کنید.


مدل های مولد هوش مصنوعی گوگل در مناطق خاصی در دسترس هستند.

هنگامی که سرویس Backend API Vertex AI Gemini را در کد خود راه اندازی می کنید، می توانید به صورت اختیاری مکان مدلی را که در درخواست های خود به آن دسترسی دارید مشخص کنید. اگر مکانی را مشخص نکنید، پیش‌فرض us-central1 است. لیست مکان های موجود را در ادامه این صفحه مشاهده کنید.

درباره مکان global بیاموزید

برای دسترسی به مدل‌های Gemini 2.0 و Gemini 2.5 ، Vertex AI Gemini API از یک مکان global پشتیبانی می‌کند، به این معنی که درخواست شما توسط یک مدل موجود در هر نقطه از استخر جهانی بررسی می‌شود. تنظیم مکان روی global برای درخواست‌های شما می‌تواند در دسترس بودن کلی را بهبود بخشد و در عین حال خطاهای تمام شده منابع (429) را کاهش دهد.

همچنین، مدل‌های آزمایشی و پیش‌نمایش Gemini 2.5 که پس از ژوئن 2025 منتشر شده‌اند، فقط در مکان global قابل دسترسی هستند.

نمونه کد

توجه داشته باشید که این نمونه‌ها دسترسی به مدل Gemini را نشان می‌دهند، اما هنگام دسترسی به مدل Imagen می‌توانید مکان را نیز مشخص کنید.

LOCATION با کد مکان (به عنوان مثال، europe-west4 ) از لیست مکان های موجود در آینده در این صفحه جایگزین کنید.

سویفت 

// ...

// 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');

// ...

وحدت 

// ...

// 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");

// ...

مکان های موجود

Google Cloud از مناطق استفاده می کند. Google Cloud فقط داده‌های مشتری را در منطقه‌ای ذخیره می‌کند که شما برای همه ویژگی‌های عمومی در دسترس هوش مصنوعی در Vertex AI مشخص کرده‌اید.

هوش مصنوعی مولد در Vertex AI در مناطق زیر موجود است. برخی از مدل‌ها و/یا نسخه‌های خاص ممکن است در همه مکان‌ها در دسترس نباشند (برای در دسترس بودن مکان دقیق، به مستندات Google Cloud مراجعه کنید).

مدل‌های Gemini 2.0 و Gemini 2.5 نیز در یک مکان global در دسترس هستند. مکان global برای مدل های Imagen پشتیبانی نمی شود.

ایالات متحده

  • کلمبوس، اوهایو ( us-east5 )
  • دالاس، تگزاس ( us-south1 )
  • آیووا ( us-central1 )
  • لاس وگاس، نوادا ( us-west4 )
  • Moncks Corner، کارولینای جنوبی ( 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 1)
  • هنگ کنگ، چین ( asia-east2 )
  • بمبئی، هند ( asia-south1 )
  • سئول، کره ( asia-northeast3 )
  • سنگاپور ( asia-southeast1 )
  • سیدنی، استرالیا ( australia-southeast1 )
  • توکیو، ژاپن ( asia-northeast1 1)

خاورمیانه

  • دمام، عربستان سعودی ( me-central2 )
  • دوحه، قطر ( me-central1 )
  • تل آویو، اسرائیل ( me-west1 )