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

انقر على مزوّد Gemini API لعرض المحتوى والرمز الخاصين بالمزوّد على هذه الصفحة.


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

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

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

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

بالإضافة إلى ذلك، لا يمكن عادةً الوصول إلى نماذج Gemini 2.5 المعاينة والتجريبية التي تم إصدارها بعد يونيو 2025 إلا في الموقع الجغرافي global.

global لا يتوافق الموقع الجغرافي معهما.

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

يُرجى العِلم أنّ هذه النماذج تعرض كيفية الوصول إلى نموذج Gemini، ولكن يمكنك أيضًا تحديد موقع جغرافي عند الوصول إلى نموذج Imagen.

استبدِل LOCATION برمز الموقع الجغرافي (مثلاً، europe-west4) من قائمة المواقع الجغرافية المتاحة في وقت لاحق من هذه الصفحة.

Swift

// ...

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

// ...

Unity

// ...

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

// ...

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

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

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

تتوفّر أيضًا الطرازان Gemini 2.0 وGemini 2.5 (باستثناء Gemini 2.0 Flash 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)