|
انقر على مقدّم Gemini API للاطّلاع على المحتوى والتعليمات البرمجية الخاصة بالمقدّم على هذه الصفحة. |
تتوفّر نماذج الذكاء الاصطناعي التوليدي من Google في مناطق معيّنة. يمكنك اختيار المكان الذي تريد الوصول منه إلى النموذج لتلبية متطلبات الامتثال والمدة الزمنية للاستجابة والتوفّر والمتانة.
عند استخدام Firebase AI Logic، يمكن أن تتضمّن كل طلباتك التي تستخدم Agent Platform Gemini API (formerly Vertex AI) اختياريًا الموقع الجغرافي للوصول إلى النموذج. Firebase AI Logic تتضمّن إعدادات الموقع الجغرافي التلقائية.
- عند استخدام بنية الإعداد الجديدة "Agent Platform":
global - عند استخدام بنية الإعداد القديمة "Vertex AI":
us-central1
بالنسبة إلى جميع نماذج Gemini تقريبًا، يتيح Agent Platform Gemini API (formerly Vertex AI) استخدام
الموقع الجغرافي global، ما يعني أنّ نموذجًا متاحًا في أي مكان في المجموعة العالمية سيتولى معالجة طلبك. يمكن أن يساعدك استخدام الموقع الجغرافي global لطلباتك في تجنُّب بلوغ حدود سعة النموذج وتقليل أخطاء "الخدمة مثقلة" (503). أيضًا، قد يكون استخدام الموقع الجغرافي global مطلوبًا حسب النموذج.
متى يكون من الضروري تحديد الموقع الجغرافي بشكلٍ صريح؟
Firebase AI Logic تتضمّن إعدادات تلقائية للموقع الجغرافي (على سبيل المثال،
global عند استخدام بنية الإعداد "Agent Platform"). ومع ذلك، إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكلٍ صريح أثناء إعداد خدمة
Agent Platform Gemini API (formerly Vertex AI) الخلفية في التعليمات البرمجية.
قد يكون تحديد الموقع الجغرافي بشكلٍ صريح مطلوبًا حسب النموذج.
إذا كان طلبك يحاول الوصول إلى نموذج في موقع جغرافي غير متوفّر فيه،
سيظهر لك خطأ 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 نماذج: تتوفّر في العديد من المواقع الجغرافية.
Gemini Live API نماذج: لا تتوفّر إلا في الموقع الجغرافي
us-central1. لا يتيح الموقع الجغرافيglobalعدم.
يمكنك الاطّلاع على قائمة بجميع المواقع الجغرافية المتاحة لاحقًا على هذه الصفحة.
الحقائق العامة وأفضل الممارسات
في ما يلي بعض الحقائق الرئيسية وأفضل الممارسات حول المواقع الجغرافية:
تكون حدود السعة لكل نموذج ولكل منطقة ولكل دقيقة.
لتجنُّب بلوغ حدود السعة بشكلٍ غير متوقّع، ننصحك باستخدام الموقع الجغرافي
global(إذا كان النموذج يتيح ذلك).globalننصحك باستخدام Firebase Remote Config للتحكّم في الموقع الجغرافي الذي تصل منه إلى النموذج. بهذه الطريقة، يمكنك تغيير الموقع الجغرافي بدون إصدار إصدار جديد من تطبيقك.
إذا لم يكن استخدام الموقع الجغرافي
globalمناسبًا أو متاحًا لحالة الاستخدام، ننصحك بتوزيع المواقع الجغرافية التي تصل منها إلى النماذج بشكلٍ صريح. على سبيل المثال، يمكنك ضبط الموقع الجغرافي استنادًا إلى الموقع الجغرافي للمستخدِم النهائي باستخدام Firebase Remote Config.
عيّنات تعليمات برمجية
Firebase AI Logic تتضمّن إعدادات تلقائية للموقع الجغرافي (على سبيل المثال،
global عند استخدام بنية الإعداد "Agent Platform"). ومع ذلك، إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكلٍ صريح أثناء إعداد خدمة
Agent Platform Gemini API (formerly Vertex AI) الخلفية في التعليمات البرمجية.
استبدِل LOCATION برمز الموقع الجغرافي (على سبيل المثال، global أو
europe-west4) من قائمة المواقع الجغرافية المتاحة
لاحقًا على هذه الصفحة.
بنية Agent Platform
Swift
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
let ai = FirebaseAI.firebaseAI(backend: .agentPlatform(location: "LOCATION"))
// ...
Kotlin
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
val ai = Firebase.ai(backend = GenerativeBackend.agentPlatform(location = "LOCATION"))
// ...
Java
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.agentPlatform("LOCATION"));
// ...
Web
// ...
// Initialize FirebaseApp
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatformBackend` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
const ai = getAI(firebaseApp, { backend: new AgentPlatformBackend('LOCATION') });
// ...
Dart
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `agentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
final ai = await FirebaseAI.agentPlatform(location: 'LOCATION');
// ...
Unity
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the `AgentPlatform` syntax, the default location is `global`, so
// specifying a location is usually optional since most models are supported in `global`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.AgentPlatform(location: "LOCATION"));
// ...
بنية Vertex AI
Swift
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexai` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
let ai = FirebaseAI.firebaseAI(backend: .vertexai(location: "LOCATION"))
// ...
Kotlin
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))
// ...
Java
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));
// ...
Web
// ...
// Initialize FirebaseApp
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });
// ...
Dart
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');
// ...
Unity
// ...
// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central`, so
// specifying a location is usually required since most models are *not* supported in `us-central`.
var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.VertexAI(location: "LOCATION"));
// ...
يُرجى العِلم أنّه إذا حدّدت موقعًا جغرافيًا لا يتوفّر فيه النموذج، سيظهر لك
خطأ 404 يشير إلى النموذج
was not found or your project does not have access to it.
المواقع الجغرافية المتاحة
Google Cloud تستخدم المناطق. لا تخزّن Google Cloud بيانات العملاء إلا في المنطقة التي تحدّدها لجميع الميزات المتاحة للجميع في الذكاء الاصطناعي التوليدي على Agent Platform.
يتوفّر الذكاء الاصطناعي التوليدي على Agent Platform في المناطق التالية. قد لا تتوفّر بعض النماذج و/أو الإصدارات المحدّدة في جميع المواقع الجغرافية (للاطّلاع على مدى توفّر المواقع الجغرافية بالتفصيل، يُرجى الرجوع إلى مستندات 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غير متاح.
جميع أنحاء العالم
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)