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

تتوفّر نماذج الذكاء الاصطناعي التوليدي من Google في مناطق معيّنة.

عند تهيئة خدمة الخلفية Vertex AI Gemini API في التعليمات البرمجية، يمكنك تحديد موقع النموذج الذي تريد الوصول إليه في طلباتك. يمكنك الاطّلاع على قائمة المواقع الجغرافية المتاحة لاحقًا على هذه الصفحة.

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

قد يكون ضبط هذا الموقع الجغرافي مطلوبًا حسب النموذج:

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

• Gemini 3.x نماذج: يجب ضبط الموقع الجغرافي على global عند استخدام Firebase AI Logic.

• Gemini 2.5 نماذج: ضبط الموقع الجغرافي اختياري. إذا لم تحدّد موقعًا جغرافيًا، يكون الموقع الجغرافي التلقائي هو us-central1.

• Gemini Live API نماذج: ضبط الموقع الجغرافي اختياري. إذا لم تحدّد موقعًا جغرافيًا، يكون الموقع الجغرافي التلقائي هو us-central1. يُرجى العِلم أنّ الموقع الجغرافي global غير متاح.

في ما يلي بعض الحقائق الأساسية وأفضل الممارسات حول المواقع الجغرافية:

• تكون حدود السعة لكل نموذج في كل منطقة في الدقيقة.

• لتجنُّب بلوغ حدود السعة بشكل غير متوقّع، ننصحك بضبط الموقع الجغرافي على global (إذا كان النموذج يتيح استخدام الموقع الجغرافي global).

• إذا لم يكن ضبط الموقع الجغرافي على global مناسبًا أو متاحًا لحالة الاستخدام، ننصحك بتوزيع المواقع الجغرافية التي تصل منها إلى النماذج بشكل صريح. على سبيل المثال، يمكنك ضبط الموقع الجغرافي استنادًا إلى موقع المستخدِم النهائي باستخدام Firebase Remote Config.

عيّنات تعليمات برمجية

يُرجى العِلم أنّ هذه العيّنات توضّح كيفية الوصول إلى نموذج 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 المستندات).

لاحظ ما يلي:

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

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

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