تحديد الموقع الجغرافي للوصول إلى النموذج

تتوفّر نماذج الذكاء الاصطناعي التوليدي من Google في مناطق معيّنة. يجب أن يتضمّن كل طلب من طلباتك التي تستخدم Vertex AI Gemini API الموقع الجغرافي للوصول إلى النموذج. Firebase AI Logic يتم تلقائيًا ضبط us-central1 لجميع الطلبات.

بالنسبة إلى جميع نماذج Gemini تقريبًا، تتيح Vertex AI Gemini API استخدام موقع جغرافي global، ما يعني أنّ نموذجًا متاحًا في أي مكان ضمن المجموعة العالمية سيتولّى معالجة طلبك. يمكن أن يساعدك استخدام الموقع الجغرافي global لطلباتك في تجنُّب بلوغ حدود سعة النموذج وتقليل أخطاء "الخدمة مثقلة" (503). قد يكون استخدام الموقع الجغرافي global مطلوبًا أيضًا، وذلك حسب النموذج.

متى يكون من الضروري تحديد الموقع الجغرافي بشكلٍ صريح؟

بما أنّ Firebase AI Logic يتم ضبطه تلقائيًا على us-central1 لجميع الطلبات، عليك تحديد الموقع الجغرافي بشكلٍ صريح أثناء تهيئة خدمة الخلفية لـ Vertex AI Gemini API في التعليمات البرمجية إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك.

قد يكون تحديد الموقع الجغرافي بشكلٍ صريح مطلوبًا، وذلك حسب النموذج. إذا حاول طلبك الوصول إلى نموذج في موقع جغرافي غير متوفّر فيه، سيظهر لك الخطأ 404 الذي يشير إلى أنّه was not found or your project does not have access to it.

• Gemini نماذج المعاينة: من الضروري تحديد الموقع الجغرافي على أنّه global بشكلٍ صريح (باستثناء نماذج معاينة Live API).

• Gemini 3.x نماذج: من الضروري تحديد الموقع الجغرافي على أنّه global عند استخدام Firebase AI Logic. لا يتيح 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 لجميع الطلبات. إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكلٍ صريح أثناء تهيئة خدمة الخلفية لـ Vertex AI Gemini API في التعليمات البرمجية.

يُرجى العِلم أنّ هذه العيّنات تعرض الوصول إلى نموذج 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");

// ...

يُرجى العِلم أنّه إذا حدّدت موقعًا جغرافيًا لا يتوفّر فيه النموذج، سيظهر لك الخطأ 404 الذي يشير إلى أنّه was not found or your project does not have access to it.

المواقع الجغرافية المتاحة

Google Cloud تستخدم المناطق. لا تخزّن Google Cloud بيانات العملاء إلا في المنطقة التي تحدّدها لجميع الميزات المتاحة للجميع في الذكاء الاصطناعي التوليدي على Vertex AI.

يتوفّر الذكاء الاصطناعي التوليدي على Vertex AI في المناطق التالية. قد لا تتوفّر بعض النماذج و/أو الإصدارات المحدّدة في جميع المواقع الجغرافية (للاطّلاع على مدى توفّر المواقع الجغرافية بالتفصيل، يُرجى الرجوع إلى مستندات Google CloudGoogle Cloud).

لاحظ ما يلي:

• يتم تلقائيًا ضبط Firebase AI Logic على الموقع الجغرافي us-central1.

• بالنسبة إلى جميع Gemini نماذج المعاينة (باستثناء نماذج Live API)، الموقع الجغرافي الوحيد المتاح هو global.

• عند استخدام Firebase AI Logic للوصول إلى نماذج Gemini 3.x، الموقع الجغرافي الوحيد المتاح هو global. لا يتيح Firebase AI Logic بعد استخدام الموقعَين الجغرافيَين us وeu.

• بالنسبة إلى جميع نماذج Live API وجميع نماذج Imagen، global لايتيح استخدام الموقع الجغرافي.