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

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

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

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

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

• إذا لم تحدّد موقعًا جغرافيًا، سيكون الموقع الجغرافي التلقائي هو us-central1.

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

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

التعرّف على الموقع الجغرافي global

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

// ...

// ...

// 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")

// ...

// ...

// 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);

// ...

// ...

// 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' });

// ...

// ...

// 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");

// ...

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

المواقع الجغرافية التي يتوفّر فيها التطبيق

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

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

تتوفّر جميع نماذج Gemini (باستثناء نماذج Gemini Live) أيضًا في global. بالنسبة إلى طُرز Imagen، لا يتوفّر الموقع الجغرافي global.