Gemini API को कॉल करने पर होने वाली सामान्य समस्याओं का पता लगाने और उन्हें हल करने के लिए, इस गाइड का इस्तेमाल करें. आपको Gemini API बैकएंड सेवा या क्लाइंट 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 | आपके एपीआई पासकोड के पास ज़रूरी अनुमतियां नहीं हैं. | गलत एपीआई पासकोड का इस्तेमाल किया जा रहा है; सही पुष्टि किए बिना, ट्यून किए गए मॉडल का इस्तेमाल किया जा रहा है. | देखें कि आपकी एपीआई पासकोड सेट है या नहीं और उसके पास सही ऐक्सेस है या नहीं. साथ ही, ट्यून किए गए मॉडल का इस्तेमाल करने के लिए, सही पुष्टि करना न भूलें. |
| 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 | सेवा, तय समयसीमा के अंदर प्रोसेसिंग पूरी नहीं कर पा रही है. | आपका प्रॉम्प्ट (या संदर्भ) इतना बड़ा है कि उसे समय पर प्रोसेस नहीं किया जा सकता. | इस गड़बड़ी से बचने के लिए, अपने क्लाइंट अनुरोध में ज़्यादा 'टाइम आउट' सेट करें. |
मॉडल पैरामीटर की गड़बड़ियों के लिए, अपने एपीआई कॉल की जांच करना
पक्का करें कि आपके मॉडल पैरामीटर इन वैल्यू के बीच हों:
| मॉडल पैरामीटर | वैल्यू (रेंज) |
| उम्मीदवारों की संख्या | 1 से 8 (पूर्णांक) |
| तापमान | 0.0-1.0 |
| ज़्यादा से ज़्यादा आउटपुट टोकन |
इस्तेमाल किए जा रहे मॉडल के लिए ज़्यादा से ज़्यादा टोकन तय करने के लिए,
get_model (Python) का इस्तेमाल करें.
|
| TopP | 0.0-1.0 |
पैरामीटर वैल्यू की जांच करने के अलावा, पक्का करें कि आपने सही एपीआई वर्शन का इस्तेमाल किया हो. उदाहरण के लिए, /v1 या /v1beta) और ऐसा मॉडल चुनें जिसमें आपकी ज़रूरत के हिसाब से सुविधाएं हों. उदाहरण के लिए, अगर कोई सुविधा बीटा रिलीज़ में है, तो वह सिर्फ़ /v1beta एपीआई वर्शन में उपलब्ध होगी.
देखें कि आपके पास सही मॉडल है या नहीं
पक्का करें कि आपने हमारे मॉडल पेज पर दिए गए, काम करने वाले मॉडल का इस्तेमाल किया हो.
सुरक्षा से जुड़ी समस्याएं
अगर आपको एपीआई कॉल में सुरक्षा सेटिंग की वजह से, प्रॉम्प्ट ब्लॉक होने का मैसेज दिखता है, तो एपीआई कॉल में सेट किए गए फ़िल्टर के हिसाब से प्रॉम्प्ट की समीक्षा करें.
अगर आपको BlockedReason.OTHER दिखता है, तो हो सकता है कि क्वेरी या जवाब, सेवा की शर्तों का उल्लंघन करता हो या काम न करता हो.
कविता सुनाने से जुड़ी समस्या
अगर आपको लगता है कि मॉडल, दोहराए जाने की वजह से आउटपुट जनरेट करना बंद कर देता है, तो इसका मतलब है कि मॉडल का आउटपुट कुछ डेटा से मिलता-जुलता हो सकता है. इसे ठीक करने के लिए, प्रॉम्प्ट / संदर्भ को जितना हो सके उतना यूनीक बनाएं और ज़्यादा तापमान का इस्तेमाल करें.
मॉडल के आउटपुट को बेहतर बनाना
बेहतर क्वालिटी के मॉडल आउटपुट के लिए, ज़्यादा स्ट्रक्चर्ड प्रॉम्प्ट लिखें. प्रॉम्प्ट इंजीनियरिंग गाइड पेज पर, आपको कुछ बुनियादी कॉन्सेप्ट, रणनीतियां, और सबसे सही तरीके के बारे में जानकारी मिलती है.
अगर आपके पास अच्छे इनपुट/आउटपुट पेयर के सैकड़ों उदाहरण हैं, तो मॉडल ट्यूनिंग पर भी विचार किया जा सकता है.
टोकन की सीमाओं के बारे में जानकारी
टोकन की गिनती करने और उनकी सीमाओं को समझने के लिए, टोकन गाइड पढ़ें.
ज्ञात समस्याएं
- एपीआई सिर्फ़ कुछ चुनिंदा भाषाओं के साथ काम करता है. जिन भाषाओं में प्रॉम्प्ट सबमिट करने की सुविधा उपलब्ध नहीं है उनमें प्रॉम्प्ट सबमिट करने पर, अनचाहे जवाब मिल सकते हैं. इसके अलावा, जवाब ब्लॉक भी किए जा सकते हैं. अपडेट के लिए, उपलब्ध भाषाएं देखें.
गड़बड़ी की शिकायत करें
अगर आपका कोई सवाल है, तो Google के एआई डेवलपर फ़ोरम पर जाकर, बातचीत में शामिल हों.