इस पेज पर, Gemini API और Firebase AI Logic एसडीके टूल से जुड़ी गड़बड़ी के सामान्य कोड को हल करने का तरीका बताया गया है.
400 गड़बड़ी: API key not valid. Please pass a valid API key.
अगर आपको 400 गड़बड़ी का कोड मिलता है, जिसमें API key not valid. Please pass a valid API key. लिखा है, तो आम तौर पर इसका मतलब है कि आपकी Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में एपीआई पासकोड मौजूद नहीं है या उसे आपके ऐप्लिकेशन और/या Firebase प्रोजेक्ट के साथ इस्तेमाल करने के लिए सेट अप नहीं किया गया है.
देखें कि आपकी Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में मौजूद एपीआई पासकोड, आपके ऐप्लिकेशन के एपीआई पासकोड से मेल खाता हो. Google Cloud कंसोल में एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपने सभी एपीआई पासकोड देखे जा सकते हैं.
अगर आपको पता चलता है कि वे मैच नहीं करते हैं, तो एक नई Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट पाएं. इसके बाद, अपने ऐप्लिकेशन में मौजूद फ़ाइल/ऑब्जेक्ट को बदलें. नई कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में, आपके ऐप्लिकेशन और Firebase प्रोजेक्ट के लिए एक मान्य एपीआई पासकोड होना चाहिए.
400 गड़बड़ी: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
अगर Cloud Storage for Firebase यूआरएल का इस्तेमाल करके मल्टीमोडल अनुरोध भेजने की कोशिश की जाती है, तो आपको 400 गड़बड़ी का यह मैसेज मिल सकता है:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.
यह गड़बड़ी तब होती है, जब किसी प्रोजेक्ट में Agent Platform एपीआई चालू होने पर, ज़रूरी सेवा एजेंट अपने-आप सही तरीके से उपलब्ध नहीं होते. यह कुछ प्रोजेक्ट में होने वाली एक आम समस्या है. हम इसे ठीक करने के लिए काम कर रहे हैं.
अपने प्रोजेक्ट को ठीक करने और इन सर्विस एजेंट को सही तरीके से प्रावधान करने का तरीका यहां बताया गया है. इससे, मल्टीमोडल अनुरोधों में Cloud Storage for Firebase यूआरएल शामिल किए जा सकेंगे. यह ज़रूरी है कि आप प्रोजेक्ट के मालिक हों. साथ ही, आपको अपने प्रोजेक्ट के लिए, टास्क के इस सेट को सिर्फ़ एक बार पूरा करना होगा.
gcloud CLI की मदद से ऐक्सेस करें और पुष्टि करें.
ऐसा करने का सबसे आसान तरीका है, Cloud Shell से अनुरोध करना. ज़्यादा जानने के लिए, Google Cloud दस्तावेज़ पढ़ें.अगर कहा जाए, तो टर्मिनल में दिए गए निर्देशों का पालन करें, ताकि gcloud CLI को आपके Firebase प्रोजेक्ट के लिए चलाया जा सके.
आपको अपने Firebase प्रोजेक्ट आईडी की ज़रूरत होगी. यह आईडी, Firebase कंसोल में settings प्रोजेक्ट सेटिंग में सबसे ऊपर मौजूद होता है.
यहां दिया गया कमांड चलाकर, अपने प्रोजेक्ट में ज़रूरी सर्विस एजेंट उपलब्ध कराएं:
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json" https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''
कुछ मिनट इंतज़ार करें, ताकि यह पक्का किया जा सके कि सर्विस एजेंट उपलब्ध हैं. इसके बाद, Cloud Storage for Firebase यूआरएल वाला मल्टीमोडल अनुरोध फिर से भेजें.
अगर कुछ मिनट इंतज़ार करने के बाद भी आपको यह गड़बड़ी दिखती है, तो Firebase की सहायता टीम से संपर्क करें.
403 गड़बड़ी: PERMISSION_DENIED: To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
अगर आपको 403 - PERMISSION_DENIED गड़बड़ी का मैसेज मिलता है, जिसमें लिखा है कि
To access this model, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check,
तो इसका मतलब है कि आपके अनुरोध में मान्य App Check टोकन नहीं है. साथ ही, इसका मतलब यह भी है कि आपने किसी ऐसे मॉडल को ऐक्सेस करने की कोशिश की है जिसका आम तौर पर गलत इस्तेमाल किया जाता है.
यह पता चला है कि नुकसान पहुंचाने वाले लोग या इकाइयां, कुछ जनरेटिव मॉडल का गलत इस्तेमाल करती हैं.
आपने Firebase AI Logic के लिए App Check को लागू नहीं किया है. इसलिए, आपके प्रोजेक्ट में इन मॉडल का गलत इस्तेमाल हो सकता है. हमारे डेवलपर को सुरक्षित रखने के लिए, Firebase इन मॉडल का ऐक्सेस तब तक ब्लॉक रखता है, जब तक अनुरोध में मान्य App Check टोकन शामिल न हो. इसका मतलब है कि Firebase AI Logic के लिए, App Check को लागू किया गया है.
अगर आपको गड़बड़ी दिखाने वाले मॉडल को ऐक्सेस करना है, तो यह तरीका अपनाएं:
Firebase AI Logic के लिए App Check सेट अप करें. लोकल डेवलपमेंट के लिए, पक्का करें कि आपने App Check डीबग प्रोवाइडर सेट अप किया हो.
Gemini API और Gemini मॉडल को गलत इस्तेमाल से बचाने के लिए, App Check को लागू करना ज़रूरी है. इस गड़बड़ी को ठीक करने के लिए, इसे लागू करना ज़रूरी है.
अपने ऐप्लिकेशन से Firebase AI Logic को अनुरोध फिर से भेजें.
इस अनुरोध के साथ एक मान्य App Check टोकन भेजा जाएगा. इसके बाद, आपको
403 - PERMISSION_DENIEDवाली गड़बड़ी नहीं दिखेगी.असली उपयोगकर्ताओं के लिए अपना ऐप्लिकेशन रिलीज़ करने से पहले, आपको प्रॉडक्शन अटेस्टेशन की सेवा देने वाली कंपनी सेट अप करनी होगी. जैसे, App Attest, Play Integrity या reCAPTCHA Enterprise. इससे App Check लागू होने पर, असली उपयोगकर्ता आपकी एआई की सुविधा को ऐक्सेस कर पाएंगे.
403 गड़बड़ी: PERMISSION_DENIED: Firebase AI Logic has been deactivated in this project. To resume using Firebase AI Logic, you must enforce Firebase App Check. Learn more: https://firebase.google.com/docs/ai-logic/app-check
अगर आपको 403 - PERMISSION_DENIED गड़बड़ी का मैसेज मिलता है, जिसमें लिखा है कि
Firebase AI Logic has been deactivated in this project. To resume using
Firebase AI Logic, you must enforce Firebase App Check. Learn more:
https://firebase.google.com/docs/ai-logic/app-check,
तो इसका मतलब है कि आपके Firebase प्रोजेक्ट को इनऐक्टिव के तौर पर पहचाना गया है और आपने Firebase AI Logic के लिए App Check को लागू नहीं किया है.
"इनऐक्टिव प्रोजेक्ट" वे होते हैं जिनमें Firebase AI Logic चालू होता है, लेकिन हाल ही में Firebase AI Logic का इस्तेमाल नहीं किया गया होता.
आपने Firebase AI Logic के लिए App Check को लागू नहीं किया है. इसलिए, आपके प्रोजेक्ट में Gemini API का गलत इस्तेमाल हो सकता है. आपके प्रोजेक्ट को सुरक्षित रखने के लिए, Firebase ने Firebase AI Logic का इस्तेमाल बंद कर दिया है. यह तब तक बंद रहेगा, जब तक Firebase AI Logic के लिए App Check को लागू नहीं किया जाता.
जब आप Firebase AI Logic का फिर से इस्तेमाल करने के लिए तैयार हों, तो यह तरीका अपनाएं:
Firebase AI Logic के लिए App Check को सेट अप करें. लोकल डेवलपमेंट के लिए, पक्का करें कि आपने App Check डीबग प्रोवाइडर सेट अप किया हो.
Gemini API और Gemini मॉडल को गलत इस्तेमाल से बचाने के लिए, App Check को लागू करना ज़रूरी है. इस गड़बड़ी को ठीक करने के लिए, इसे लागू करना ज़रूरी है.
अपने ऐप्लिकेशन से Firebase AI Logic को अनुरोध फिर से भेजें.
इस अनुरोध के साथ एक मान्य App Check टोकन भेजा जाएगा. इसके बाद, आपको
403 - PERMISSION_DENIEDगड़बड़ी का यह मैसेज नहीं दिखेगा.अगर आपने पहले से ही App Check को लागू किया हुआ है और आपको अब भी यह गड़बड़ी दिख रही है, तो देखें कि Firebase AI Logic के लिए रीप्ले प्रोटेक्शन चालू है या नहीं. इसमें "सिर्फ़ मॉनिटर करें" मोड भी शामिल है.
रीप्ले प्रोटेक्शन की सुविधा चालू होने पर, Firebase AI Logic के लिए सिर्फ़ एक बार इस्तेमाल होने वाले टोकन को पुष्टि किए गए टोकन के तौर पर गिना जाता है. सामान्य सेशन टोकन से यह गड़बड़ी ठीक नहीं होती. अपने ऐप्लिकेशन में एक बार इस्तेमाल होने वाले टोकन चालू करें या Firebase AI Logic के लिए, रीप्ले प्रोटेक्शन की सुविधा बंद करें. इसके बाद, अनुरोध फिर से भेजें और रीप्ले प्रोटेक्शन की सुविधा को फिर से चालू करने से पहले, करीब एक दिन इंतज़ार करें. प्रोजेक्ट की गतिविधि का फिर से आकलन हर दिन किया जाता है.
असली उपयोगकर्ताओं के लिए अपना ऐप्लिकेशन रिलीज़ करने से पहले, आपको प्रॉडक्शन अटेस्टेशन की सेवा देने वाली कंपनी सेट अप करनी होगी. जैसे, App Attest, Play Integrity या reCAPTCHA Enterprise. इससे App Check लागू होने पर, असली उपयोगकर्ता आपकी एआई की सुविधा को ऐक्सेस कर पाएंगे.
403 गड़बड़ी: PERMISSION_DENIED: The caller does not have permission.
अगर आपको 403 गड़बड़ी का कोड मिलता है, जिसमें लिखा है कि
PERMISSION_DENIED: The caller does not have permission., तो आम तौर पर इसका मतलब है कि
आपकी Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में मौजूद एपीआई पासकोड, किसी दूसरे
Firebase प्रोजेक्ट का है.
देखें कि आपकी Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में मौजूद एपीआई पासकोड, आपके ऐप्लिकेशन के एपीआई पासकोड से मेल खाता हो. Google Cloud कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपने सभी एपीआई पासकोड देखे जा सकते हैं.
अगर आपको पता चलता है कि वे मेल नहीं खाते हैं, तो एक नई Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट पाएं. इसके बाद, अपने ऐप्लिकेशन में मौजूद फ़ाइल/ऑब्जेक्ट को बदलें. नई कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में, आपके ऐप्लिकेशन और Firebase प्रोजेक्ट के लिए एक मान्य एपीआई पासकोड होना चाहिए.
403 गड़बड़ी: Requests to this API firebasevertexai.googleapis.com ... are blocked.
अगर आपको 403 गड़बड़ी का कोड मिलता है, जिसमें Requests to this API firebasevertexai.googleapis.com ... are blocked. लिखा है, तो आम तौर पर इसका मतलब है कि आपके ऐप्लिकेशन में Firebase कॉन्फ़िगरेशन में मौजूद एपीआई पासकोड पर पाबंदियां लगी हैं. इन पाबंदियों की वजह से, ज़रूरी एपीआई को कॉल नहीं किया जा सकता.
इस समस्या को ठीक करने के लिए, आपको Google Cloud कंसोल में जाकर, अपने एपीआई पासकोड से जुड़ी पाबंदियों को अपडेट करना होगा, ताकि ज़रूरी एपीआई को शामिल किया जा सके. Firebase AI Logic के लिए,
आपको यह पक्का करना होगा कि Firebase AI Logic एपीआई
(firebasevertexai.googleapis.com) को चुने गए एपीआई की सूची में शामिल किया गया हो.
इस सूची में शामिल एपीआई को एपीआई पासकोड का इस्तेमाल करके कॉल किया जा सकता है.
यह तरीका अपनाएं:
Google Cloud कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पैनल खोलें.
वह एपीआई पासकोड चुनें जिसे इस्तेमाल करने के लिए आपके ऐप्लिकेशन को कॉन्फ़िगर किया गया है. उदाहरण के लिए, iOS ऐप्लिकेशन के लिए "iOS पासकोड".
एपीआई पासकोड में बदलाव करें पेज पर, एपीआई से जुड़ी पाबंदियां सेक्शन ढूंढें.
पक्का करें कि कुंजी पर पाबंदी लगाएं विकल्प चुना गया हो. अगर ऐसा नहीं है, तो आपकी कुंजी पर कोई पाबंदी नहीं है. साथ ही, गड़बड़ी की वजह यह नहीं है.
चुने गए एपीआई ड्रॉप-डाउन मेन्यू में, Firebase AI Logic एपीआई को खोजें और चुनें. इससे वह चुने गए एपीआई की सूची में जुड़ जाएगा. इस सूची में मौजूद एपीआई को एपीआई पासकोड का इस्तेमाल करके कॉल किया जा सकता है.
सेव करें पर क्लिक करें.
बदलावों को लागू होने में पांच मिनट लग सकते हैं.
404 कोड वाली गड़बड़ी: Firebase AI Logic genai config not found
अगर आपको 404 गड़बड़ी का कोड मिलता है, जिसमें Firebase AI Logic genai config not found लिखा है, तो आम तौर पर इसका मतलब है कि Firebase AI Logic की कोई सेटिंग गलत तरीके से कॉन्फ़िगर की गई है या मौजूद नहीं है.
इस गड़बड़ी की सबसे संभावित वजहें यहां दी गई हैं:
आपने अब तक Gemini API सेवा देने वाली कंपनी के लिए, अपना Firebase प्रोजेक्ट सेट अप नहीं किया है.
क्या करना है:
Firebase कंसोल में, एआई सेवाएं > एआई लॉजिक पर जाएं. शुरू करें पर क्लिक करें. इसके बाद, Gemini API की सेवा देने वाली वह कंपनी चुनें जिसे आपने चुना है. एपीआई को चालू करें. इसके बाद, Firebase उस सेवा देने वाली कंपनी के लिए आपका प्रोजेक्ट सेट अप कर देगा. वर्कफ़्लो पूरा करने के बाद, फिर से अनुरोध करें.अगर आपने हाल ही में Firebase कंसोल में Firebase AI Logic सेटअप वर्कफ़्लो को पूरा किया है, तो हो सकता है कि Firebase AI Logic का कॉन्फ़िगरेशन, लागू होने वाले सभी इलाकों में ज़रूरी बैकएंड सेवाओं के लिए अभी उपलब्ध न हो.
क्या करना चाहिए:
कुछ मिनट इंतज़ार करें और फिर से कोशिश करें.
404 गड़बड़ी: "was not found or your project does not have access to it" मॉडल?
उदाहरण के लिए: "Publisher Model projects/PROJECT-ID/locations/us-central1/publishers/google/models/gemini-3.1-pro-preview was not found or your project does not have access to it. Please ensure you are using a valid model version."
इस तरह की गड़बड़ी होने की कुछ अलग-अलग वजहें हो सकती हैं.
मॉडल का नाम अमान्य है
वजह: आपने मॉडल का जो नाम दिया है वह मान्य नहीं है.
ठीक करने का तरीका: इस्तेमाल किए जा सकने वाले और उपलब्ध सभी मॉडल की सूची में, अपने मॉडल का नाम और मॉडल का वर्शन देखें. मॉडल के नाम में सेगमेंट और उनके क्रम की जांच ज़रूर करें. उदाहरण के लिए:
- सबसे नया Gemini 4 Argon
मॉडल का नाम:
gemini-4-argon - Gemini 3.x Pro के नए मॉडल का नाम:
gemini-3.1-pro-preview(सिर्फ़ झलक के तौर पर उपलब्ध है) - सबसे नया Gemini 3.x Flash
मॉडल का नाम:
gemini-3.8-flash - सबसे नया Gemini 3.x Flash‑Lite
मॉडल का नाम:
gemini-3.5-flash-lite - सबसे नया Gemini Nano Banana 2.1
मॉडल का नाम:
gemini-nano-banana-2.1 - सबसे नया Gemini Nano Banana 2
मॉडल का नाम:
gemini-3.1-flash-image - सबसे नया Gemini Nano Banana 2 Lite
मॉडल का नाम:
gemini-3.1-flash-lite-image - सबसे नया Gemini Nano Banana Pro
मॉडल का नाम:
gemini-3-pro-image
- सबसे नया Gemini 4 Argon
मॉडल का नाम:
जगह की जानकारी अमान्य है (सिर्फ़ तब लागू होता है, जब Agent Platform Gemini API (formerly Vertex AI) सेवा देने वाली कंपनी का इस्तेमाल किया जा रहा हो)
वजह: ऐसा हो सकता है कि आपके अनुरोध में किसी ऐसी जगह पर मौजूद मॉडल को ऐक्सेस करने की कोशिश की जा रही हो जहां वह मॉडल उपलब्ध नहीं है.
ठीक करने का तरीका: पक्का करें कि आपका अनुरोध, उस मॉडल को ऐक्सेस करने की कोशिश कर रहा हो जहां वह उपलब्ध है.
Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल करते समय, आपके पास मॉडल को शुरू करने के दौरान उसे ऐक्सेस करने के लिए, कोई जगह तय करने का विकल्प होता है. अगर आपने कोई जगह नहीं चुनी है, तो Firebase AI Logic डिफ़ॉल्ट रूप से इन जगहों पर फ़ाइलें डाउनलोड करेगा:
- "Agent Platform" को शुरू करने वाले सिंटैक्स का इस्तेमाल करते समय:
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में उपलब्ध नहीं हैं.
- "Agent Platform" को शुरू करने वाले सिंटैक्स का इस्तेमाल करते समय:
मॉडल को ऐक्सेस करने के लिए जगह की जानकारी देने के तरीके के बारे में ज़्यादा जानें. इसमें कोड स्निपेट भी शामिल हैं.
429 गड़बड़ियां: "You exceeded your current quota, please check your plan and billing details" या "Resource exhausted, please try again later."
इस तरह की गड़बड़ी होने की कुछ अलग-अलग वजहें हो सकती हैं.
आपने तय सीमा से ज़्यादा प्रॉम्प्ट इस्तेमाल कर लिए हैं या जिस मॉडल को ऐक्सेस किया जा रहा है उस पर अन्य लोगों के अनुरोधों की वजह से ज़्यादा लोड है.
आपको कौनसी कार्रवाई करनी है, यह इस बात पर निर्भर करता है कि Gemini Developer API या Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल किया जा रहा है. कोटा और अतिरिक्त कोटा का अनुरोध करने के तरीके के बारे में ज़्यादा जानने के लिए, दर की सीमाएं और कोटा देखें.
अगर Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल किया जा रहा है, तो Google Cloud दस्तावेज़ में गड़बड़ी कोड 429 के बारे में कुछ और जानकारी और दिशा-निर्देश दिए गए हैं.
आपने किसी ऐसे मॉडल या सुविधा का इस्तेमाल करने की कोशिश की है जिसके लिए बिलिंग की ज़रूरत होती है. हालांकि, आपका Firebase प्रोजेक्ट, स्पार्क प्लान पर है.
Gemini Developer API का इस्तेमाल करने पर, आपको कुछ मॉडल का सीमित ऐक्सेस मिल सकता है. साथ ही, Gemini Developer API के "फ़्री टियर" में कई बुनियादी सुविधाओं का ऐक्सेस मिल सकता है. इस टियर में, पेमेंट का तरीका बताए बिना ही शुरुआत की जा सकती है. इसका मतलब है कि आपको अपने Firebase प्रोजेक्ट को, इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर अपग्रेड करने की ज़रूरत नहीं है.
कुछ मॉडल, Gemini Developer API के "फ़्री टियर" पर उपलब्ध नहीं हैं. इन्हें इस्तेमाल करने के लिए, "पेड टियर" की ज़रूरत होती है. इसका मतलब है कि आपके प्रोजेक्ट के लिए, इस्तेमाल के हिसाब से पैसे चुकाने वाला ब्लेज़ प्लान होना चाहिए. उदाहरण के लिए, इन मॉडल के लिए आम तौर पर बिलिंग की ज़रूरत होती है:
- झलक और एक्सपेरिमेंट के तौर पर उपलब्ध ज़्यादातर मॉडल
- मीडिया जनरेट करने वाले मॉडल (जैसे, Gemini Nano Banana मॉडल)
कुछ मॉडल, Gemini Developer API "फ़्री टियर" में कुछ बुनियादी सुविधाएँ देते हैं. हालाँकि, ज़्यादा ऐडवांस सुविधाओं का इस्तेमाल करने के लिए, "पैसे चुकाकर लिए जाने वाले टियर" की ज़रूरत होती है. उदाहरण के लिए:
- ज़्यादातर Gemini 3.x मॉडल का इस्तेमाल करते समय,
Google Search याGoogle Maps की मदद से ग्राउंडिंग करने के लिए बिलिंग ज़रूरी है.
- ज़्यादातर Gemini 3.x मॉडल का इस्तेमाल करते समय,
Firebase के बिलिंग प्लान और Gemini Developer API के बारे में जानें.
ज़्यादा जानकारी के लिए, Gemini Developer API कीमत से जुड़ा दस्तावेज़ और बिलिंग के बारे में अक्सर पूछे जाने वाले सवाल देखें.