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

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 Google Cloud Console में, एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपने सभी एपीआई पासकोड देखे जा सकते हैं.

अगर आपको पता चलता है कि ये पासकोड मेल नहीं खाते हैं, तो Firebase का नया कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट पाएं, इसके बाद, अपने ऐप्लिकेशन में मौजूद कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट को बदलें. नए कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में, आपके ऐप्लिकेशन और Firebase प्रोजेक्ट के लिए मान्य एपीआई पासकोड होना चाहिए.

400 गड़बड़ी: Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

अगर मल्टीमॉडल अनुरोध भेजा जा रहा है, तो आपको 400 गड़बड़ी दिख सकती है:Cloud Storage for Firebase
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. अगर आपसे पूछा जाता है, तो टर्मिनल में दिखाए गए निर्देशों का पालन करके, gcloud CLI को अपने Firebase प्रोजेक्ट के ख़िलाफ़ चलाएं.

   आपके पास Firebase प्रोजेक्ट का आईडी होना चाहिए. यह आईडी, settings प्रोजेक्ट सेटिंग में सबसे ऊपर मौजूद होता है.Firebase

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: 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 चालू हो, लेकिन हाल ही में उसका इस्तेमाल न किया गया हो.

Firebase AI Logic का फिर से इस्तेमाल करने के लिए, यह तरीका अपनाएं:

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

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

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

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

3. जब एआई सुविधा को एंड-यूज़र के लिए रिलीज़ करना हो, तो पक्का करें कि आप चालू रखेंApp Check लागू किया गया हो और App Check 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 Google Cloud Console में, एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपने सभी एपीआई पासकोड देखे जा सकते हैं.

अगर आपको पता चलता है कि ये पासकोड मेल नहीं खाते हैं, तो 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 API (firebasevertexai.googleapis.com), चुने गए उन एपीआई की सूची में शामिल हो जिन्हें एपीआई पासकोड का इस्तेमाल करके कॉल किया जा सकता है.

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

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

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

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

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

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

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

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

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 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 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 जगह के लिए, यह सुविधा नहीं उपलब्ध है.

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

429 गड़बड़ियां: "You exceeded your current quota, please check your plan and billing details" या "Resource exhausted, please try again later."

429 गड़बड़ियां तब दिखती हैं, जब आपने अपना कोटा पूरा कर लिया हो या जिस मॉडल को ऐक्सेस किया जा रहा है उस पर अन्य लोगों के अनुरोधों की वजह से ज़्यादा लोड हो.

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

अगर Agent Platform Gemini API (formerly Vertex AI) का इस्तेमाल किया जा रहा है, तो Google Cloud दस्तावेज़ में, गड़बड़ी कोड 429 के बारे में ज़्यादा जानकारी और निर्देश दिए गए हैं.