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

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

मॉडल के हिसाब से, जगह की जानकारी को साफ़ तौर पर सेट करना ज़रूरी हो सकता है. अगर आपका अनुरोध किसी ऐसी जगह पर मौजूद मॉडल को ऐक्सेस करने की कोशिश करता है जहां वह उपलब्ध नहीं है, तो आपको 404 गड़बड़ी का मैसेज मिलेगा. इसमें बताया जाएगा कि मॉडल was not found or your project does not have access to it.

• Gemini preview और experimental मॉडल: ये सिर्फ़ global लोकेशन में उपलब्ध हैं. हालाँकि, Live API मॉडल को छोड़कर (नीचे देखें).

• Gemini 3.x मॉडल: ये सिर्फ़ Firebase AI Logic का इस्तेमाल करते समय, global जगह पर उपलब्ध हैं. 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) से बदलें.

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

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

// ...

// ...

// 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 में ही सिर्फ़ जगह की जानकारी उपलब्ध है.

• Gemini 3.x मॉडल को ऐक्सेस करने के लिए Firebase AI Logic का इस्तेमाल करते समय, global में ही जगह की जानकारी सिर्फ़ काम करती है. Firebase AI Logic में, us और eu जगहों के लिए, अभी सहायता उपलब्ध नहीं है.

• सभी Live API मॉडल और सभी Imagen मॉडल के लिए, global की जगह की जानकारी नहीं दी जा सकती.