गड़बड़ी के कोड

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 यूआरएल शामिल किए जा सकें. आपके पास प्रोजेक्ट का मालिक वाला रोल होना चाहिए. साथ ही, आपको अपने प्रोजेक्ट के लिए, टास्क का यह सेट सिर्फ़ एक बार पूरा करना होगा.

1. gcloud CLI की मदद से ऐक्सेस करें और पुष्टि करें.
   ऐसा करने का सबसे आसान तरीका Cloud Shell है. ज़्यादा जानने के लिए, Google Cloud दस्तावेज़ पढ़ें.

2. अगर कहा जाए, तो टर्मिनल में दिखाए गए निर्देशों का पालन करके, अपने Firebase प्रोजेक्ट के लिए gcloud CLI चलाएं.

   आपको अपने Firebase प्रोजेक्ट आईडी की ज़रूरत होगी. यह आपको Firebase कंसोल में, settings प्रोजेक्ट सेटिंग के सबसे ऊपर दिखेगा.

3. अपने प्रोजेक्ट में ज़रूरी सेवा एजेंट उपलब्ध कराने के लिए, यह निर्देश चलाएं:

   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 ''
   

4. कुछ मिनट इंतज़ार करें, ताकि सेवा एजेंट उपलब्ध हो सकें. इसके बाद, मल्टीमॉडल अनुरोध को फिर से भेजें. इसमें 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 लागू किया गया है.

अगर आपको उस मॉडल को ऐक्सेस करना है जिससे गड़बड़ी हुई है, तो यह तरीका अपनाएं:

1. Firebase AI Logic के लिए App Check सेट अप करें. लोकल डेवलपमेंट के लिए, पक्का करें कि आपने App Check डीबग प्रोवाइडर सेट अप किया हो.

   App Check को लागू करना ज़रूरी है, ताकि Gemini API और Gemini मॉडल को गलत इस्तेमाल से बचाया जा सके. इस गड़बड़ी को ठीक करने के लिए, इसे लागू करना ज़रूरी है.

2. अपने ऐप्लिकेशन से Firebase AI Logic को अनुरोध फिर से भेजें.

   इस अनुरोध के साथ एक मान्य App Check टोकन भेजा जाएगा. इसके बाद, आपको यह 403 - PERMISSION_DENIED गड़बड़ी नहीं दिखेगी.

3. अपने ऐप्लिकेशन को असली उपयोगकर्ताओं के लिए रिलीज़ करने से पहले, आपको प्रोडक्शन अटेस्टेशन प्रोवाइडर सेट अप करना होगा. जैसे, 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 का फिर से इस्तेमाल करने के लिए, यह तरीका अपनाएं:

1. Firebase AI Logic के लिए App Check सेट अप करें. लोकल डेवलपमेंट के लिए, पक्का करें कि आपने App Check डीबग प्रोवाइडर सेट अप किया हो.

   App Check को लागू करना ज़रूरी है, ताकि Gemini API और Gemini मॉडल को गलत इस्तेमाल से बचाया जा सके. इस गड़बड़ी को ठीक करने के लिए, इसे लागू करना ज़रूरी है.

2. अपने ऐप्लिकेशन से Firebase AI Logic को अनुरोध फिर से भेजें.

   इस अनुरोध के साथ एक मान्य App Check टोकन भेजा जाएगा. इसके बाद, आपको यह 403 - PERMISSION_DENIED गड़बड़ी नहीं दिखेगी.

3. अपने ऐप्लिकेशन को असली उपयोगकर्ताओं के लिए रिलीज़ करने से पहले, आपको प्रोडक्शन अटेस्टेशन प्रोवाइडर सेट अप करना होगा. जैसे, 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) को चुने गए एपीआई की सूची में शामिल किया गया हो. इन एपीआई को एपीआई पासकोड का इस्तेमाल करके कॉल किया जा सकता है.

यह तरीका अपनाएं:

1. Google Cloud कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पैनल खोलें.

2. वह एपीआई पासकोड चुनें जिसका इस्तेमाल करने के लिए आपका ऐप्लिकेशन कॉन्फ़िगर किया गया है. उदाहरण के लिए, iOS ऐप्लिकेशन के लिए "iOS पासकोड".

3. एपीआई पासकोड में बदलाव करें पेज पर, एपीआई से जुड़ी पाबंदियां सेक्शन ढूंढें.

4. पक्का करें कि कुंजी पर पाबंदी लगाएं विकल्प चुना गया हो. अगर ऐसा नहीं है, तो आपकी कुंजी पर कोई पाबंदी नहीं है. इस वजह से, गड़बड़ी होने की संभावना कम है.

5. चुने गए एपीआई ड्रॉप-डाउन मेन्यू में, Firebase AI Logic API खोजें और उसे चुनें. इससे यह एपीआई, चुने गए उन एपीआई की सूची में जुड़ जाएगा जिन्हें एपीआई पासकोड का इस्तेमाल करके कॉल किया जा सकता है.

6. सेव करें पर क्लिक करें.

   बदलावों को लागू होने में पांच मिनट तक लग सकते हैं.

404 गड़बड़ी: Firebase AI Logic genai config not found

अगर आपको 404 गड़बड़ी का मैसेज मिलता है, जिसमें Firebase AI Logic genai config not found लिखा होता है, तो आम तौर पर इसका मतलब है कि Firebase AI Logic की कोई सेटिंग गलत तरीके से कॉन्फ़िगर की गई है या मौजूद नहीं है.

इस गड़बड़ी की ये वजहें हो सकती हैं:

• आपने अब तक Gemini API प्रोवाइडर के लिए, Firebase प्रोजेक्ट सेट अप नहीं किया है.

  क्या करें:
  Firebase console में, एआई सेवाएं > एआई लॉजिक पर जाएं. शुरू करें पर क्लिक करें. इसके बाद, 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 3.x Pro मॉडल का नाम: gemini-3.1-pro-preview (सिर्फ़ झलक में उपलब्ध है)
    • नया Gemini 3.x Flash मॉडल का नाम: gemini-3.7-flash
    • नया Gemini 3.x Flash‑Lite मॉडल का नाम: gemini-3.5-flash-lite
    • नवीनतम Gemini 3.x Pro Image (इसे "Nano Banana Pro" भी कहा जाता है) मॉडल का नाम: gemini-3-pro-image
    • नया Gemini 3.x Flash Image (इसे "Nano Banana 2" भी कहा जाता है) मॉडल का नाम: gemini-3.1-flash-image
    • नया Gemini 3.x Flash‑Lite Image (इसे "Nano Banana 2 Lite" भी कहा जाता है) मॉडल का नाम: gemini-3.1-flash-lite-image
    • नवीनतम Gemini 2.5 Flash Image (इसे "Nano Banana" भी कहा जाता है) मॉडल का नाम: gemini-2.5-flash-image

• जगह की जानकारी अमान्य है (यह सिर्फ़ तब लागू होता है, जब 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 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 जगह के लिए, यह सुविधा उपलब्ध नहीं है.

  मॉडल को ऐक्सेस करने के लिए जगह की जानकारी देने के बारे में ज़्यादा जानें. इसमें कोड स्निपेट भी शामिल हैं.

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 प्रोजेक्ट Spark प्लान पर है.

  Gemini Developer API का इस्तेमाल करने पर, आपको कुछ मॉडल का सीमित ऐक्सेस मिल सकता है. साथ ही, Gemini Developer API के "फ़्री टियर" में, आपको कई बुनियादी सुविधाओं का ऐक्सेस भी मिलता है. इस टियर को बिना पेमेंट के तरीके की जानकारी दिए इस्तेमाल किया जा सकता है. इसका मतलब है कि आपको अपने Firebase प्रोजेक्ट को इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान में अपग्रेड करने की ज़रूरत नहीं है.

  • कुछ मॉडल, Gemini Developer API "मुफ़्त टियर" पर उपलब्ध नहीं हैं. इनके लिए "पैसे चुकाकर लिया गया टियर" ज़रूरी है. इसका मतलब है कि आपका प्रोजेक्ट, इस्तेमाल के हिसाब से पैसे चुकाने वाले Blaze प्लान पर होना चाहिए. उदाहरण के लिए, इन मॉडल के लिए बिलिंग की ज़रूरत होती है:

    • ज़्यादातर प्रीव्यू और एक्सपेरिमेंट के तौर पर उपलब्ध मॉडल
    • इमेज जनरेट करने वाले मॉडल ("Nano Banana" मॉडल)

  • कुछ मॉडल, Gemini Developer API के "फ़्री टियर" में कुछ बुनियादी सुविधाएं देते हैं. हालांकि, ज़्यादा ऐडवांस सुविधाओं का इस्तेमाल करने के लिए, आपको "पैसे चुकाकर लिया जाने वाला टियर" खरीदना होगा. उदाहरण के लिए:

    • Gemini 3.x के ज़्यादातर मॉडल इस्तेमाल करते समय, Google Search या Google Maps के साथ ग्राउंडिंग करने के लिए बिलिंग ज़रूरी है.

  Firebase के प्राइसिंग प्लान और Gemini Developer API के बारे में जानें.

  ज़्यादा जानकारी के लिए, Gemini Developer API कीमत से जुड़ा दस्तावेज़ और बिलिंग के बारे में अक्सर पूछे जाने वाले सवाल देखें.