|
انقر على مقدّم 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 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._لا_ يتوفّر الموقع الجغرافي
globalلجميع نماذج Live API وجميع نماذج 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)
آسيا والمحيط الهادئ
- Changhua County، تايوان (
asia-east1) - هونغ كونغ، الصين (
asia-east2) - مومباي، الهند (
asia-south1) - سول، كوريا (
asia-northeast3) - سنغافورة (
asia-southeast1) - سيدني، أستراليا (
australia-southeast1) - طوكيو، اليابان (
asia-northeast1)
الشرق الأوسط
- الدمام، المملكة العربية السعودية (
me-central2) - الدوحة، قطر (
me-central1) - تل أبيب، إسرائيل (
me-west1)