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

تتوفّر نماذج الذكاء الاصطناعي التوليدي من 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 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 تحديد الموقع الجغرافي .