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

مدل‌های هوش مصنوعی زایای 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
• europe-west2 (لندن، پادشاهی متحد)
• ‫asia-southeast1 (سنگاپور)

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

مدل‌های نسل قدیمی‌تر

هنگام استفاده از مدل‌های قدیمی‌تر Gemini (مانند مدل‌های 2.5)، Firebase AI Logic از مکان‌های زیر پشتیبانی می‌کند:

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

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

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

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