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

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


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

هنگام مقداردهی اولیه سرویس backend API مربوط به Vertex AI Gemini در کد خود، می‌توانید به صورت اختیاری مکان مدلی را که در درخواست‌های خود به آن دسترسی دارید، مشخص کنید. لیست مکان‌های موجود را بعداً در این صفحه مشاهده کنید.

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

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

  • اگر مکانی را مشخص نکنید، پیش‌فرض us-central1 است.

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

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

درباره موقعیت global اطلاعات کسب کنید

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

نمونه‌های کد

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

// ...

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

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

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

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

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

ایالات متحده

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

خاورمیانه

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