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

इस गाइड की मदद से, आम तौर पर होने वाली समस्याओं का पता लगाकर उन्हें ठीक किया जा सकता है तो Gemini API को कॉल किया जा सकता है. हाई लेवल पर आपको, इनमें से किसी एक से समस्या का सामना करना पड़ सकता है तो Gemini API की बैकएंड सेवा या क्लाइंट SDK टूल की मदद से भी ऐसा किया जा सकता है. हमारे क्लाइंट SDK टूल यह डेटा अलग-अलग सोर्स से लिया गया है:

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

Gemini API की बैकएंड सेवा से जुड़ी गड़बड़ी के कोड

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

एचटीटीपी कोड स्टेटस जानकारी उदाहरण समाधान
400 INVALID_ARGUMENT अनुरोध का मुख्य हिस्सा गलत है. आपके अनुरोध में टाइपिंग की कोई गड़बड़ी है या ज़रूरी फ़ील्ड में कोई जानकारी नहीं है. अनुरोध के फ़ॉर्मैट, उदाहरणों, और इस्तेमाल किए जा सकने वाले वर्शन के लिए, एपीआई का संदर्भ देखें. पुराने एंडपॉइंट के साथ एपीआई के नए वर्शन की सुविधाओं का इस्तेमाल करने से गड़बड़ियां हो सकती हैं.
400 FAILED_PRECONDITION Gemini API का फ़्री टियर आपके देश में उपलब्ध नहीं है. कृपया Google AI Studio में जाकर, अपने प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें. आपने ऐसे इलाके में अनुरोध किया है जहां फ़्री टीयर काम नहीं करता और आपने Google AI Studio में अपने प्रोजेक्ट के लिए बिलिंग की सुविधा चालू नहीं की है. Gemini API का इस्तेमाल करने के लिए, आपको Google AI Studio की मदद से, पैसे चुकाकर लिया गया प्लान सेट अप करना होगा.
403 PERMISSION_DENIED आपके एपीआई पासकोड के पास ज़रूरी अनुमतियां नहीं हैं. आप गलत API कुंजी का उपयोग कर रहे हैं; की पहचान करें सही तरीके से पुष्टि किए बिना, ट्यून किए गए मॉडल का इस्तेमाल करने की कोशिश करते हों. देखें कि आपने एपीआई पासकोड सेट किया है या नहीं. साथ ही, यह देखें कि उसके पास सही ऐक्सेस है या नहीं. इसके अलावा, ट्यून किए जाने वाले मॉडल का इस्तेमाल करने के लिए, सही तरीके से पुष्टि करने की सुविधा का इस्तेमाल करें.
404 NOT_FOUND अनुरोध किया गया संसाधन नहीं मिला. आपके अनुरोध में रेफ़र की गई कोई इमेज, ऑडियो या वीडियो फ़ाइल नहीं मिली. देखें कि एपीआई वर्शन के लिए, आपके अनुरोध के सभी पैरामीटर मान्य हैं या नहीं.
429 RESOURCE_EXHAUSTED आप तय सीमा से ज़्यादा अनुरोध कर चुके हैं. Gemini API के फ़्री टीयर का इस्तेमाल करके, हर मिनट कई अनुरोध भेजे जा रहे हैं. पक्का करें कि आप मॉडल के लिए तय की गई दर की सीमा के अंदर हैं. अगर ज़रूरी हो, तो कोटा बढ़ाने का अनुरोध करें.
500 आंतरिक Google की तरफ़ से कोई गड़बड़ी हुई. इनपुट का कॉन्टेक्स्ट बहुत लंबा है. इनपुट का कॉन्टेक्स्ट कम करें या कुछ समय के लिए किसी दूसरे मॉडल पर स्विच करें (जैसे, Gemini 1.5 Pro से Gemini 1.5 Flash). इसके बाद, देखें कि यह काम करता है या नहीं. इसके अलावा, थोड़ी देर इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो कृपया Google AI Studio में सुझाव/राय भेजें या शिकायत करें बटन का इस्तेमाल करके इसकी शिकायत करें.
503 हवा की क्वालिटी की जानकारी उपलब्ध नहीं है शायद सेवा कुछ समय के लिए ओवरलोड हो या बंद हो जाए. सेवा की कुछ समय के लिए क्षमता खत्म हो रही है. कुछ समय के लिए, किसी दूसरे मॉडल पर स्विच करें (जैसे, Gemini 1.5 Pro से Gemini 1.5 Flash पर) और देखें कि यह काम करता है या नहीं. इसके अलावा, थोड़ी देर इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो कृपया Google AI Studio में सुझाव/राय भेजें या शिकायत करें बटन का इस्तेमाल करके इसकी शिकायत करें.
504 DEADLINE_EXCEEDED इस सेवा के लिए तय समयसीमा के अंदर प्रोसेस पूरी नहीं की जा सकती. आपके प्रॉम्प्ट या कॉन्टेक्स्ट का साइज़ बहुत बड़ा है. इसलिए, उसे समय पर प्रोसेस नहीं किया जा सकता. बड़ा 'समय खत्म' सेट करें के लिए अपने क्लाइंट अनुरोध पर क्लिक करें.

Python क्लाइंट SDK टूल के गड़बड़ी के कोड

नीचे दी गई टेबल में सामान्य सूची दी गई है Python क्लाइंट SDK टूल में गड़बड़ी जो आपको मिलने वाले कोड के साथ-साथ उनके कारणों के बारे में भी जानकारी देते हैं:

अपवाद/गड़बड़ी का प्रकार कक्षा ब्यौरा
BlockedPromptException google.generativeai.types.BlockedPromptException सुरक्षा की वजह से, प्रॉम्प्ट को ब्लॉक कर दिया गया है.
BrokenResponseError google.generativeai.types.BrokenResponseError स्ट्रीमिंग रिस्पॉन्स में गड़बड़ी हुई. यह सूचना तब दिखती है, जब किसी ऐसे कॉन्टेंट को ऐक्सेस किया जाता है जिसके लिए पूरा जवाब देना ज़रूरी होता है. जैसे, चैट का इतिहास. स्टैक ट्रेस में दी गई गड़बड़ी की जानकारी देखें.
IncompleteIterationError google.generativeai.types.IncompleteIterationError यह सूचना तब दी जाती है, जब किसी ऐसी चीज़ को ऐक्सेस किया जाता है जिसके लिए एपीआई से पूरा रिस्पॉन्स चाहिए. हालांकि, स्ट्रीमिंग रिस्पॉन्स पूरी तरह से दोहराया नहीं गया है. इटरेटर का इस्तेमाल करने के लिए, रिस्पॉन्स ऑब्जेक्ट पर resolve() को कॉल करें.
StopCandidateException google.generativeai.types.StopCandidateException एपीआई ने बेहतरीन finish_reason के साथ जवाब दिया. आगे बढ़ने के तरीके के बारे में सलाह पाने की वजह देखें.
PermissionDenied google.api_core.exceptions.PermissionDenied आपके पास अनुरोध किए गए संसाधन (उदाहरण के लिए, मॉडल) की अनुमति नहीं है.
ResourceExhausted google.api_core.exceptions.ResourceExhausted आपका कोटा खत्म हो गया है. कृपया थोड़ी देर बाद कोशिश करें. इन गड़बड़ियों को ठीक करने के लिए, अपने-आप फिर से कोशिश करने की सुविधा सेट अप करें.
AlreadyExists google.api_core.exceptions.AlreadyExists इसी आईडी वाला एक ट्यून किया गया मॉडल पहले से मौजूद है. नया मॉडल ट्यून करते समय, कृपया एक यूनीक मॉडल आईडी बताएं.
InvalidArgument google.api_core.exceptions.InvalidArgument गलत तर्क. एक उदाहरण यह है कि फ़ाइल बहुत बड़ी है और पेलोड का साइज़ तय सीमा से ज़्यादा है. कोई दूसरा एपीआई पासकोड उपलब्ध करा रहा है.
DefaultCredentialsError google.auth.exceptions.DefaultCredentialsError पुष्टि नहीं हो सकी. कृपया अपने एपीआई पासकोड की दोबारा जांच करें और फिर से कोशिश करें.
RetryError google.api_core.exceptions.RetryError ऐसा किसी ऐसे प्रॉक्सी का इस्तेमाल करते समय हो सकता है जो gRPC के साथ काम नहीं करता. genai.configure(..., transport="rest") के साथ REST ट्रांसपोर्ट इस्तेमाल करके देखें.

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

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

मॉडल पैरामीटर वैल्यू (रेंज)
उम्मीदवारों की संख्या 1-8 (पूर्णांक)
तापमान 0.0 से 1.0
ज़्यादा से ज़्यादा आउटपुट टोकन इस्तेमाल की जाने वाली चीज़ें get_model (Python) इस्तेमाल किए जा रहे मॉडल के लिए टोकन की ज़्यादा से ज़्यादा संख्या तय करने के लिए.
TopP 0.0 से 1.0

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

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

पक्का करें कि इस्तेमाल किया जा सकने वाला ऐसा मॉडल इस्तेमाल किया जा रहा हो जो हमारी मॉडल पेज पर जाएं.

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

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

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

उच्चारण से जुड़ी समस्या

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

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

अच्छी क्वालिटी वाले मॉडल आउटपुट के लिए, स्ट्रक्चर्ड प्रॉम्प्ट लिखने के बारे में ज़्यादा जानें. कॉन्टेंट बनाने प्रॉम्प्ट डिज़ाइन का परिचय पेज के बारे में जानकारी कुछ बुनियादी कॉन्सेप्ट, रणनीतियों, और सबसे सही तरीकों के बारे में बताया है.

अगर आपके पास इनपुट/आउटपुट जोड़े के सैकड़ों उदाहरण हैं, तो मॉडल ट्यूनिंग के बारे में सोचें.

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

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

पहले से मालूम समस्याएं

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

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

Google के एआई डेवलपर फ़ोरम पर चर्चा में शामिल हों पर आएं.