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

مدل‌های هوش مصنوعی مولد گوگل در مناطق خاصی در دسترس هستند. هر یک از درخواست‌های شما که از API مربوط به Vertex AI Gemini استفاده می‌کنند، باید شامل مکان دسترسی به مدل باشند. Firebase AI Logic به طور خودکار برای همه درخواست‌ها به صورت پیش‌فرض روی us-central1 تنظیم شده است.

تقریباً برای همه مدل‌های Gemini ، رابط برنامه‌نویسی کاربردی Vertex AI Gemini از یک موقعیت مکانی global پشتیبانی می‌کند، به این معنی که درخواست شما توسط یک مدل موجود در هر کجای مخزن جهانی مدیریت خواهد شد. استفاده از موقعیت مکانی global برای درخواست‌های شما می‌تواند به شما کمک کند تا از رسیدن به محدودیت‌های ظرفیت مدل جلوگیری کرده و خطاهای "سرویس بیش از حد" (503) را کاهش دهید. همچنین، بسته به مدل، ممکن است استفاده از موقعیت مکانی global مورد نیاز باشد.

چه زمانی تعیین صریح مکان مورد نیاز است؟

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

بسته به مدل، ممکن است نیاز به تنظیم صریح یک مکان باشد. اگر درخواست شما سعی در دسترسی به مدلی در مکانی داشته باشد که در دسترس نیست، خطای ۴۰۴ دریافت خواهید کرد که می‌گوید مدل was not found or your project does not have access to it .

• مدل‌های پیش‌نمایش Gemini : تنظیم صریح موقعیت مکانی به global الزامی است (به جز مدل‌های پیش‌نمایش Live API ).

• مدل‌های Gemini 3.x : هنگام استفاده از Firebase AI Logic، تنظیم صریح موقعیت مکانی به global الزامی است. Firebase AI Logic هنوز از موقعیت‌های مکانی us و eu پشتیبانی نمی‌کند.

• مدل‌های Gemini 2.5 : تنظیم صریح مکان اختیاری است، اما توصیه می‌شود. اگر مکانی را مشخص نکنید، پیش‌فرض us-central1 است.

• مدل‌های Gemini Live API : تنظیم صریح مکان اختیاری است، اما توصیه می‌شود. اگر مکانی را مشخص نکنید، پیش‌فرض us-central1 است. توجه داشته باشید که مکان global پشتیبانی نمی‌شود .

لیست تمام مکان‌های موجود را بعداً در این صفحه مشاهده کنید.

حقایق کلی و بهترین شیوه‌ها

در اینجا به برخی از حقایق کلیدی و بهترین شیوه‌ها در مورد مکان‌ها اشاره می‌کنیم:

• محدودیت‌های ظرفیت به ازای هر مدل، به ازای هر منطقه و به ازای هر دقیقه است.

• برای جلوگیری از مواجهه غیرمنتظره با محدودیت‌های ظرفیت، تنظیم موقعیت مکانی را روی global ) در نظر بگیرید (اگر مدل شما از موقعیت مکانی global پشتیبانی می‌کند).

• برای کنترل مکانی که به مدل دسترسی دارید، می‌توانید از Firebase Remote Config استفاده کنید. به این ترتیب، می‌توانید مکان را بدون انتشار نسخه جدید برنامه خود تغییر دهید.

• اگر تنظیم موقعیت مکانی به global برای مورد استفاده شما قابل اجرا یا پشتیبانی نیست، توزیع صریح مکان دسترسی به مدل‌ها را در نظر بگیرید. برای مثال، می‌توانید با استفاده از Firebase Remote Config موقعیت مکانی را بر اساس موقعیت مکانی کاربر نهایی خود تنظیم کنید.

نمونه‌های کد

منطق هوش مصنوعی فایربیس (Firebase AI Logic) به طور خودکار برای همه درخواست‌ها به صورت پیش‌فرض روی us-central1 تنظیم شده است. اگر نیاز دارید یا می‌خواهید از مکان دیگری استفاده کنید، باید هنگام مقداردهی اولیه سرویس backend API Vertex AI Gemini در کد خود، مکان را به صراحت مشخص کنید.

توجه داشته باشید که این نمونه‌ها دسترسی به یک مدل 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");

// ...

توجه داشته باشید که اگر مکانی را مشخص کنید که مدل در آن موجود نباشد، خطای ۴۰۴ دریافت خواهید کرد که می‌گوید مدل was not found or your project does not have access to it .

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

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

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

به موارد زیر توجه کنید:

• منطق هوش مصنوعی فایربیس به طور پیش‌فرض روی مکان us-central1 قرار دارد.

• برای همه مدل‌های پیش‌نمایش Gemini (به جز مدل‌های Live API )، تنها مکان پشتیبانی‌شده، global است.

• هنگام استفاده از Firebase AI Logic برای دسترسی به مدل‌های Gemini 3.x ، تنها موقعیت مکانی پشتیبانی‌شده، موقعیت مکانی global است. Firebase AI Logic هنوز از موقعیت مکانی us و eu پشتیبانی نمی‌کند.

• برای همه مدل‌های Live API و همه مدل‌های Imagen ، موقعیت مکانی global پشتیبانی نمی‌شود .