समस्या हल करने के लिए गाइड

Gemini API को कॉल करने पर होने वाली सामान्य समस्याओं की पहचान करने और उन्हें हल करने के लिए, इस गाइड का इस्तेमाल करें. आपको Gemini API के बैकएंड सर्विस या क्लाइंट SDK से जुड़ी समस्याएं आ सकती हैं. हमारे क्लाइंट SDK, इन रिपॉज़िटरी में ओपन सोर्स के तौर पर उपलब्ध हैं:

• python-genai
• js-genai
• go-genai

अगर आपको एपीआई पासकोड से जुड़ी समस्याएं आ रही हैं, तो पक्का करें कि आपने अपना एपीआई पासकोड सही तरीके से सेट अप किया हो. इसके लिए, एपीआई पासकोड सेटअप करने की गाइड देखें.

Gemini API के बैकएंड सर्विस के गड़बड़ी कोड

यहां दी गई टेबल में, बैकएंड की सामान्य गड़बड़ियों के कोड दिए गए हैं. साथ ही, उनकी वजहों और उन्हें ठीक करने के तरीके भी बताए गए हैं:

मॉडल पैरामीटर की गड़बड़ियों के लिए, अपने एपीआई कॉल की जांच करना

पक्का करें कि आपके मॉडल पैरामीटर की वैल्यू, यहां दी गई वैल्यू के अंदर हों:

पैरामीटर की वैल्यू की जांच करने के अलावा, यह भी पक्का करें कि आपने एपीआई का सही वर्शन (जैसे, /v1 या /v1beta) और ऐसा मॉडल इस्तेमाल किया हो जो आपकी ज़रूरत की सुविधाओं के साथ काम करता हो. उदाहरण के लिए, अगर कोई सुविधा बीटा रिलीज़ में है, तो वह सिर्फ़ /v1beta एपीआई वर्शन में उपलब्ध होगी.

यह देखना कि आपके पास सही मॉडल है या नहीं

पक्का करें कि आपने हमारे मॉडल पेज पर सूची में शामिल, काम करने वाला मॉडल इस्तेमाल किया हो.

2.5 मॉडल के साथ, ज़्यादा इंतज़ार करना पड़ना या ज़्यादा टोकन इस्तेमाल होना

अगर आपको 2.5 Flash और Pro मॉडल के साथ, ज़्यादा इंतज़ार करना पड़ रहा है या ज़्यादा टोकन इस्तेमाल हो रहे हैं, तो इसकी वजह यह हो सकती है कि इनकी क्वालिटी बेहतर बनाने के लिए, सोचने की सुविधा डिफ़ॉल्ट रूप से चालू होती है. अगर आपकी प्राथमिकता स्पीड है या आपको लागत कम करनी है, तो सोचने की सुविधा को अडजस्ट या बंद किया जा सकता है.

निर्देशों और सैंपल कोड के लिए, सोचने की सुविधा वाला पेज देखें.

सुरक्षा से जुड़ी समस्याएं

अगर आपको दिखता है कि एपीआई कॉल में सुरक्षा सेटिंग की वजह से कोई प्रॉम्प्ट ब्लॉक कर दिया गया है, तो एपीआई कॉल में सेट किए गए फ़िल्टर के हिसाब से, उस प्रॉम्प्ट की समीक्षा करें.

अगर आपको BlockedReason.OTHER दिखता है, तो हो सकता है कि क्वेरी या जवाब, सेवा की शर्तों का उल्लंघन करता हो या वह काम न करता हो.

रेसाइटेशन से जुड़ी समस्या

अगर आपको दिखता है कि RECITATION की वजह से मॉडल ने आउटपुट जनरेट करना बंद कर दिया है, तो इसका मतलब है कि मॉडल का आउटपुट, किसी डेटा से मिलता-जुलता हो सकता है. इसे ठीक करने के लिए, प्रॉम्प्ट / कॉन्टेक्स्ट को जितना हो सके उतना यूनीक बनाने की कोशिश करें और ज़्यादा तापमान का इस्तेमाल करें.

बार-बार इस्तेमाल होने वाले टोकन की समस्या

अगर आपको बार-बार इस्तेमाल होने वाले आउटपुट टोकन दिखते हैं, तो उन्हें कम करने या हटाने के लिए, यहां दिए गए सुझावों को आज़माएं.

          # Markdown Table Format
          
          * Separator line: Markdown tables must include a separator line below
            the header row. The separator line must use only 3 hyphens per
            column, for example: |---|---|---|. Using more hypens like
            ----, -----, ------ can result in errors. Always
            use |:---|, |---:|, or |---| in these separator strings.

            For example:

            | Date | Description | Attendees |
            |---|---|---|
            | 2024-10-26 | Annual Conference | 500 |
            | 2025-01-15 | Q1 Planning Session | 25 |

          * Alignment: Do not align columns. Always use |---|.
            For three columns, use |---|---|---| as the separator line.
            For four columns use |---|---|---|---| and so on.

          * Conciseness: Keep cell content brief and to the point.

          * Never pad column headers or other cells with lots of spaces to
            match with width of other content. Only a single space on each side
            is needed. For example, always do "| column name |" instead of
            "| column name                |". Extra spaces are wasteful.
            A markdown renderer will automatically take care displaying
            the content in a visually appealing form.
        

        When thinking silently: ALWAYS start the thought with a brief
        (one sentence) recap of the current progress on the task. In
        particular, consider whether the task is already done.
      

ब्लॉक किए गए या काम न करने वाले एपीआई पासकोड

इस सेक्शन में, यह देखने का तरीका बताया गया है कि आपका Gemini API पासकोड ब्लॉक किया गया है या नहीं. साथ ही, यह भी बताया गया है कि इस बारे में क्या करना चाहिए.

यह समझना कि पासकोड ब्लॉक क्यों किए जाते हैं

हमें एक ऐसी समस्या के बारे में पता चला है जिसकी वजह से, कुछ एपीआई पासकोड सार्वजनिक तौर पर उपलब्ध हो सकते हैं. आपके डेटा को सुरक्षित रखने और अनधिकृत ऐक्सेस से बचाने के लिए, हमने लीक हुए इन पासकोड को Gemini API को ऐक्सेस करने से रोक दिया है.

इस बात की पुष्टि करना कि आपके पासकोड पर असर पड़ा है या नहीं

अगर आपका पासकोड लीक हो गया है, तो अब उस पासकोड का इस्तेमाल Gemini API के साथ नहीं किया जा सकता. यह देखने के लिए कि आपके किसी एपीआई पासकोड को Gemini API को कॉल करने से ब्लॉक किया गया है या नहीं, Google AI Studio का इस्तेमाल किया जा सकता है. साथ ही, नए पासकोड जनरेट किए जा सकते हैं. इन पासकोड का इस्तेमाल करने की कोशिश करने पर, आपको यह गड़बड़ी भी दिख सकती है:

Your API key was reported as leaked. Please use another API key.

ब्लॉक किए गए एपीआई पासकोड के लिए कार्रवाई

आपको Google AI Studio का इस्तेमाल करके, Gemini API इंटिग्रेशन के लिए नए एपीआई पासकोड जनरेट करने चाहिए. हमारा सुझाव है कि एपीआई पासकोड मैनेज करने के तरीकों की समीक्षा करें, ताकि यह पक्का किया जा सके कि आपके नए पासकोड सुरक्षित रखे जाएं और वे सार्वजनिक तौर पर उपलब्ध न हों.

सुरक्षा में कमी की वजह से, अनचाहे शुल्क लगना

बिलिंग से जुड़ा सहायता अनुरोध सबमिट करें. हमारी बिलिंग टीम इस पर काम कर रही है. जैसे ही हमारे पास कोई अपडेट होगा, हम आपसे संपर्क करेंगे.

लीक हुए पासकोड के लिए, Google के सुरक्षा उपाय

अगर मेरे एपीआई पासकोड लीक हो जाते हैं, तो Google मेरे खाते को लागत बढ़ने और गलत इस्तेमाल से बचाने में कैसे मदद करेगा?

• हमारा लक्ष्य है कि Google AI Studio का इस्तेमाल करके, नया पासकोड जनरेट करने का अनुरोध करने पर, हम एपीआई पासकोड जारी करें. ये पासकोड डिफ़ॉल्ट रूप से सिर्फ़ Google AI Studio के लिए सीमित होंगे और अन्य सेवाओं के पासकोड स्वीकार नहीं करेंगे. इससे, पासकोड का अनचाहा क्रॉस-यूसेज रोकने में मदद मिलेगी.
• हमारा लक्ष्य है कि लीक हुए और Gemini API के साथ इस्तेमाल किए गए एपीआई पासकोड को डिफ़ॉल्ट रूप से ब्लॉक कर दिया जाए. इससे, लागत और आपके ऐप्लिकेशन डेटा के गलत इस्तेमाल को रोकने में मदद मिलेगी.
• Google AI Studio में, अपने एपीआई पासकोड का स्टेटस देखा जा सकेगा. साथ ही, जब हमें पता चलेगा कि आपके एपीआई पासकोड लीक हो गए हैं, तो हम तुरंत कार्रवाई करने के लिए, आपसे संपर्क करेंगे.

मॉडल के आउटपुट को बेहतर बनाना

मॉडल के बेहतर क्वालिटी वाले आउटपुट पाने के लिए, ज़्यादा स्ट्रक्चर्ड प्रॉम्प्ट लिखने के बारे में जानें. The prompt engineering guide page introduces some basic concepts, strategies, and best practices to get you started.

टोकन की सीमाओं के बारे में जानकारी

टोकन की गिनती करने और उनकी सीमाओं के बारे में बेहतर तरीके से जानने के लिए, हमारी टोकन गाइड पढ़ें.

ज्ञात समस्याएं

• एपीआई, सिर्फ़ चुनिंदा भाषाओं के साथ काम करता है. ऐसी भाषाओं में प्रॉम्प्ट सबमिट करने पर, अनचाहे या ब्लॉक किए गए जवाब मिल सकते हैं जो एपीआई के साथ काम नहीं करती हैं. अपडेट के लिए, देखें कि एपीआई किन भाषाओं में उपलब्ध है.

गड़बड़ी की शिकायत करें

अगर आपका कोई सवाल है, तो Google AI डेवलपर फ़ोरम पर चर्चा में शामिल हों.