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

مدل‌های هوش مصنوعی مولد گوگل در مناطق خاصی در دسترس هستند. شما می‌توانید انتخاب کنید که از کجا به این مدل دسترسی داشته باشید تا الزامات انطباق، تأخیر، در دسترس بودن و دوام خود را برآورده کنید.

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

• هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
• هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

درباره موقعیت global

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

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

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

منطق هوش مصنوعی فایربیس (Firebase AI Logic) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

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

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

به جای LOCATION ، کد مکان (مثلاً global یا us-central1 ) را از فهرست مکان‌های موجود در ادامه‌ی این صفحه انتخاب کنید.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

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

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

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

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

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

• منطق هوش مصنوعی فایربیس به صورت پیش‌فرض در مکان‌های زیر قرار دارد:

  • هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
  • هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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 (مانند مدل‌های ۲.۵)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

توجه داشته باشید که مدل‌های Gemini Live API 2.5 به صورت global در دسترس نیستند .

برای جزئیات بیشتر در مورد مکان‌های موجود برای هر مدل ، به مستندات Google Cloud مراجعه کنید.

فهرست مکان‌هایی که قبلاً در دسترس بودند، اما اکنون رد شده‌اند:

• هنوز هیچ مکانی رد نشده است

مدل‌های هوش مصنوعی مولد گوگل در مناطق خاصی در دسترس هستند. شما می‌توانید انتخاب کنید که از کجا به این مدل دسترسی داشته باشید تا الزامات انطباق، تأخیر، در دسترس بودن و دوام خود را برآورده کنید.

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

• هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
• هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

درباره موقعیت global

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

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

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

منطق هوش مصنوعی فایربیس (Firebase AI Logic) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

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

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

به جای LOCATION ، کد مکان (مثلاً global یا us-central1 ) را از فهرست مکان‌های موجود در ادامه‌ی این صفحه انتخاب کنید.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

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

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

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

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

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

• منطق هوش مصنوعی فایربیس به صورت پیش‌فرض در مکان‌های زیر قرار دارد:

  • هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
  • هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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 (مانند مدل‌های ۲.۵)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

توجه داشته باشید که مدل‌های Gemini Live API 2.5 به صورت global در دسترس نیستند .

برای جزئیات بیشتر در مورد مکان‌های موجود برای هر مدل ، به مستندات Google Cloud مراجعه کنید.

فهرست مکان‌هایی که قبلاً در دسترس بودند، اما اکنون رد شده‌اند:

• هنوز هیچ مکانی رد نشده است

مدل‌های هوش مصنوعی مولد گوگل در مناطق خاصی در دسترس هستند. شما می‌توانید انتخاب کنید که از کجا به این مدل دسترسی داشته باشید تا الزامات انطباق، تأخیر، در دسترس بودن و دوام خود را برآورده کنید.

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

• هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
• هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

درباره موقعیت global

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

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

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

منطق هوش مصنوعی فایربیس (Firebase AI Logic) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

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

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

به جای LOCATION ، کد مکان (مثلاً global یا us-central1 ) را از فهرست مکان‌های موجود در ادامه‌ی این صفحه انتخاب کنید.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

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

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

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

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

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

• منطق هوش مصنوعی فایربیس به صورت پیش‌فرض در مکان‌های زیر قرار دارد:

  • هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
  • هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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 (مانند مدل‌های ۲.۵)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

توجه داشته باشید که مدل‌های Gemini Live API 2.5 به صورت global در دسترس نیستند .

برای جزئیات بیشتر در مورد مکان‌های موجود برای هر مدل ، به مستندات Google Cloud مراجعه کنید.

فهرست مکان‌هایی که قبلاً در دسترس بودند، اما اکنون رد شده‌اند:

• هنوز هیچ مکانی رد نشده است

مدل‌های هوش مصنوعی مولد گوگل در مناطق خاصی در دسترس هستند. شما می‌توانید انتخاب کنید که از کجا به این مدل دسترسی داشته باشید تا الزامات انطباق، تأخیر، در دسترس بودن و دوام خود را برآورده کنید.

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

• هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
• هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

درباره موقعیت global

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

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

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

منطق هوش مصنوعی فایربیس (Firebase AI Logic) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

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

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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) پیش‌فرض‌های خودکاری برای مکان دارد (برای مثال، هنگام استفاده از سینتکس مقداردهی اولیه "پلتفرم عامل" (Agent Platform)، پیش‌فرض‌های global ). با این حال، اگر به مکان متفاوتی نیاز دارید یا می‌خواهید از آن استفاده کنید، باید مکان را به طور صریح در هنگام مقداردهی اولیه سرویس backend پلتفرم عامل Gemini API (که قبلاً Vertex AI نام داشت) در کد خود مشخص کنید.

به جای LOCATION ، کد مکان (مثلاً global یا us-central1 ) را از فهرست مکان‌های موجود در ادامه‌ی این صفحه انتخاب کنید.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

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

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

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

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

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

• منطق هوش مصنوعی فایربیس به صورت پیش‌فرض در مکان‌های زیر قرار دارد:

  • هنگام استفاده از سینتکس مقداردهی اولیه جدید "پلتفرم عامل": global
  • هنگام استفاده از سینتکس مقداردهی اولیه قدیمی "Vertex AI": us-central1

• مدل‌های پیش‌نمایش و آزمایشی جمینی : فقط در فروشگاه‌های 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 (مانند مدل‌های ۲.۵)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

توجه داشته باشید که مدل‌های Gemini Live API 2.5 به صورت global در دسترس نیستند .

برای جزئیات بیشتر در مورد مکان‌های موجود برای هر مدل ، به مستندات Google Cloud مراجعه کنید.

فهرست مکان‌هایی که قبلاً در دسترس بودند، اما اکنون رد شده‌اند:

• هنوز هیچ مکانی رد نشده است