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

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

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

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

درباره مکان global

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

استفاده از مکان global برای درخواست‌هایتان می‌تواند به شما کمک کند از رسیدن به محدودیت‌های ظرفیت مدل جلوگیری کنید و خطاهای «سرویس بیش‌ازحد بارگذاری شده است» (۵۰۳) را کاهش دهید. همچنین، بسته به مدل، استفاده از مکان global ممکن است الزامی باشد زیرا تنها مکان دردسترس برای مدل است (برای مثال، مدل پیش‌نمایش Gemini).

چه زمانی تنظیم صریح مکان لازم است؟

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

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

• مدل‌های Gemini پیش‌نمایش و آزمایشی: فقط در مکان global دردسترس است.

• مدل‌های پایدار Gemini 4.x و 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 دارای پیش‌فرض‌های خودکار برای مکان است (برای مثال، global هنگام استفاده از نحو مقداردهی اولیه «Agent Platform»). بااین‌حال، اگر نیاز دارید یا می‌خواهید از مکان دیگری استفاده کنید، باید صریحاً مکان را درطول مقداردهی اولیه سرویس پسای Agent Platform Gemini API (formerly 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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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 Platform مشخص می‌کنید ذخیره می‌کند.

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

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

• Firebase AI Logic به‌طور پیش‌فرض به مکان‌های زیر می‌رود:

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

• مدل‌های Gemini پیش‌نمایش و آزمایشی: فقط در مکان global دردسترس است.

• مدل‌های پایدار Gemini 4.x و 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 (مانند مدل‌های 2.5)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

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

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

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

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