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

Google के जनरेटिव एआई मॉडल, कुछ देशों या इलाकों में उपलब्ध हैं. आपके पास यह चुनने का विकल्प होता है कि आपको मॉडल को कहां से ऐक्सेस करना है. इससे आपको अपनी शर्तों का पालन करने, इंतज़ार के समय को कम करने, उपलब्धता, और टिकाऊपन से जुड़ी ज़रूरतों को पूरा करने में मदद मिलती है.

Firebase AI Logic का इस्तेमाल करते समय, Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल करने वाले आपके हर अनुरोध में, मॉडल को ऐक्सेस करने के लिए जगह की जानकारी शामिल की जा सकती है. Firebase AI Logic में जगह की जानकारी की डिफ़ॉल्ट सेटिंग होती हैं.

• नए "एजेंट प्लैटफ़ॉर्म" के इनिशलाइज़ेशन सिंटैक्स का इस्तेमाल करते समय: global
• "Vertex AI" के लेगसी इनिशलाइज़ेशन सिंटैक्स का इस्तेमाल करते समय: us-central1

global जगह के बारे में जानकारी

Gemini के ज़्यादातर मॉडल के लिए, Agent Platform Gemini API (formerly Vertex AI) global जगह की जानकारी देता है. इसका मतलब है कि आपके अनुरोध को ग्लोबल पूल में मौजूद किसी भी मॉडल से हैंडल किया जाएगा.

अपने अनुरोधों के लिए global जगह का इस्तेमाल करने से, मॉडल की क्षमता की सीमाओं को पार करने से बचा जा सकता है. साथ ही, "सेवा ओवरलोड हो गई है" (503) गड़बड़ियों को कम किया जा सकता है. इसके अलावा, मॉडल के आधार पर, global जगह का इस्तेमाल करना ज़रूरी हो सकता है. ऐसा इसलिए, क्योंकि यह मॉडल के लिए उपलब्ध एकमात्र जगह है. उदाहरण के लिए, झलक वाला Gemini मॉडल.

जगह की जानकारी को साफ़ तौर पर सेट करने की ज़रूरत कब होती है?

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 में उपलब्ध हैं.

• Gemini 4.x और Gemini 3.x के स्टेबल मॉडल: ये global जगह पर उपलब्ध होते हैं. साथ ही, अक्सर us और eu जगहों पर भी उपलब्ध होते हैं.

• Gemini 2.5 मॉडल: कई देशों/इलाकों में उपलब्ध है. ध्यान दें कि Gemini Live API 2.5 मॉडल, global में उपलब्ध नहीं हैं.

इस पेज पर, उपलब्ध सभी जगहों की सूची देखें.

सामान्य तथ्य और सबसे सही तरीके

जगहों के बारे में कुछ अहम जानकारी और सबसे सही तरीके यहां दिए गए हैं:

• कैपेसिटी की सीमाएं हर मॉडल, हर इलाके, और हर मिनट के हिसाब से तय की जाती हैं.

• क्षमता की सीमाओं को अचानक पार करने से बचने के लिए, global जगह का इस्तेमाल करें. हालांकि, ऐसा तब ही करें, जब मॉडल global जगह पर उपलब्ध हो.

• मॉडल को ऐक्सेस करने की जगह को कंट्रोल करने के लिए, Firebase Remote Config का इस्तेमाल करें. इस तरह, ऐप्लिकेशन का नया वर्शन रिलीज़ किए बिना, जगह की जानकारी बदली जा सकती है.

• अगर आपके इस्तेमाल के उदाहरण के लिए, global जगह का इस्तेमाल नहीं किया जा सकता, तो साफ़ तौर पर बताएं कि मॉडल को कहां से ऐक्सेस किया जा रहा है. ऐसा तब करें, जब मॉडल global के अलावा अन्य जगहों पर उपलब्ध हो. उदाहरण के लिए, Firebase Remote Config का इस्तेमाल करके, असली उपयोगकर्ता की जगह के आधार पर जगह सेट की जा सकती है.

कोड सैंपल

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

इस पेज पर आगे दी गई उपलब्ध जगहों की सूची से, LOCATION को जगह के कोड (उदाहरण के लिए, global या us-central1) से बदलें.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
let ai = FirebaseAI.firebaseAI(backend: .vertexAI(location: "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
val ai = Firebase.ai(backend = GenerativeBackend.vertexAI(location = "LOCATION"))

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.vertexAI("LOCATION"));

// ...

// ...

// Initialize FirebaseApp

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAIBackend` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
const ai = getAI(firebaseApp, { backend: new VertexAIBackend('LOCATION') });

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `vertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
final ai = await FirebaseAI.vertexAI(location: 'LOCATION');

// ...

// ...

// Initialize the Agent Platform Gemini API backend service (formerly branded Vertex AI).
// For the legacy `VertexAI` syntax, the default location is `us-central1`, so
// specifying a location is usually required since most models are *not* supported in `us-central1`.
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 डिफ़ॉल्ट रूप से इन जगहों पर सेव होता है:

  • नए "एजेंट प्लैटफ़ॉर्म" के इनिशलाइज़ेशन सिंटैक्स का इस्तेमाल करते समय: global
  • "Vertex AI" के लेगसी इनिशलाइज़ेशन सिंटैक्स का इस्तेमाल करते समय: us-central1

• Gemini झलक और एक्सपेरिमेंट के तौर पर उपलब्ध मॉडल: ये सिर्फ़ global में उपलब्ध हैं.

• Gemini 4.x और Gemini 3.x के स्टेबल मॉडल: ये global जगह पर उपलब्ध होते हैं. साथ ही, अक्सर us और eu जगहों पर भी उपलब्ध होते हैं.

• Gemini 2.5 मॉडल: कई देशों/इलाकों में उपलब्ध है. ध्यान दें कि Gemini Live API 2.5 मॉडल, global में उपलब्ध नहीं हैं.

Gemini 3.x और इसके बाद के मॉडल

Gemini 3.x और इसके बाद के मॉडल इस्तेमाल करने पर, Firebase AI Logic इन जगहों पर काम करता है:

• global
• us
• eu

हर मॉडल के लिए उपलब्ध जगहों के बारे में जानकारी पाने के लिए, Google Cloud दस्तावेज़ देखें.

कॉन्टेंट जनरेट करने वाले पुराने मॉडल

Gemini के पुराने मॉडल (जैसे, 2.5 मॉडल) इस्तेमाल करने पर, Firebase AI Logic को इन जगहों पर इस्तेमाल किया जा सकता है:

ध्यान दें कि Gemini Live API 2.5 मॉडल, global में उपलब्ध नहीं हैं.

हर मॉडल के लिए उपलब्ध जगहों के बारे में जानकारी पाने के लिए, Google Cloud दस्तावेज़ देखें.

उन देशों/इलाकों की सूची जहां यह सुविधा पहले उपलब्ध थी, लेकिन अब नहीं है:

• फ़िलहाल, किसी भी जगह की जानकारी को अस्वीकार नहीं किया गया है