मॉडल को ऐक्सेस करने के लिए जगह की जानकारी दें

इस पेज पर, सेवा देने वाले पार्टनर के बारे में जानकारी और कोड देखने के लिए, उसके नाम पर क्लिक करें.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 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 Remote Config.

कोड सैंपल

Firebase AI Logic में, जगह की जानकारी के लिए ऑटोमैटिक डिफ़ॉल्ट सेटिंग होती हैं. उदाहरण के लिए, global "एजेंट प्लैटफ़ॉर्म" इनिशियलाइज़ेशन सिंटैक्स का इस्तेमाल करते समय, सेटिंग डिफ़ॉल्ट रूप से सेट होती है. हालांकि, अगर आपको किसी दूसरी जगह की जानकारी का इस्तेमाल करना है या करना पड़ सकता है, तो आपको अपने कोड में, बैकएंड की सेवा को इनिशियलाइज़ करते समय, जगह की जानकारी साफ़ तौर पर बतानी होगी.Agent Platform Gemini API (formerly Vertex AI)

LOCATION की जगह, जगह का कोड डालें. उदाहरण के लिए, global या europe-west4. यह कोड, इस पेज पर बाद में दी गई, उपलब्ध जगहों की सूची से लिया जाना चाहिए.

एजेंट प्लैटफ़ॉर्म सिंटैक्स

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 पर जनरेटिव एआई की आम तौर पर उपलब्ध सभी सुविधाओं के लिए चुना है.

Google Cloud

Agent Platform पर जनरेटिव एआई, इन इलाकों में उपलब्ध है. ऐसा हो सकता है कि कुछ मॉडल और/या उनके खास वर्शन, सभी जगहों पर उपलब्ध न हों जगहों के हिसाब से उपलब्धता की ज़्यादा जानकारी के लिए, Google Cloud दस्तावेज़ देखें.

निम्न पर ध्यान दें:

  • Firebase AI Logic में, डिफ़ॉल्ट रूप से us-central1 जगह की जानकारी सेट होती है.

  • Gemini के सभी 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)