|
انقر على موفّر Gemini API لعرض المحتوى والرمز الخاصين بموفّر الخدمة على هذه الصفحة. |
تتوفّر نماذج الذكاء الاصطناعي التوليدي من Google في مناطق محدّدة. يمكنك اختيار مكان الوصول إلى النموذج لاستيفاء متطلبات الامتثال ووقت الاستجابة والتوفّر والمتانة.
عند استخدام Firebase AI Logic، يمكن أن يتضمّن كل طلب من طلباتك التي تستخدم Agent Platform Gemini API (formerly Vertex AI) بشكل اختياري الموقع الجغرافي للوصول إلى النموذج. يحتوي Firebase AI Logic على إعدادات الموقع الجغرافي التلقائية.
- عند استخدام بنية تهيئة "منصة الوكيل" الجديدة:
global - عند استخدام بنية الإعداد القديمة "Vertex AI":
us-central1
بالنسبة إلى جميع نماذج Gemini تقريبًا، يتيح Agent Platform Gemini API (formerly Vertex AI) تحديد موقع جغرافي global، ما يعني أنّ طلبك سيتم التعامل معه من خلال نموذج متاح في أي مكان ضمن المجموعة العالمية. يمكن أن يساعدك استخدام الموقع الجغرافي global في طلباتك على تجنُّب تجاوز حدود سعة النموذج وتقليل أخطاء "الخدمة محمّلة بشكل زائد" (503). بالإضافة إلى ذلك، قد يكون استخدام
global الموقع الجغرافي إلزاميًا، وذلك حسب الطراز.
متى يكون من الضروري ضبط الموقع الجغرافي بشكل صريح؟
تتضمّن Firebase AI Logic إعدادات تلقائية للموقع الجغرافي (على سبيل المثال،
global عند استخدام صيغة تهيئة "منصة الوكيل"). ومع ذلك، إذا كنت بحاجة إلى استخدام موقع جغرافي مختلف أو أردت ذلك، عليك تحديد الموقع الجغرافي بشكل صريح أثناء عملية تهيئة خدمة الخلفية 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 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 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)