Gemini API को कॉल करते समय आने वाली सामान्य समस्याओं का पता लगाने और उन्हें ठीक करने के लिए, इस गाइड का इस्तेमाल करें. अगर आपको एपीआई पासकोड से जुड़ी समस्याएं आती हैं, तो पक्का करें कि आपने एपीआई पासकोड को सेटअप करने की गाइड के मुताबिक, अपनी एपीआई पासकोड को सही तरीके से सेट अप किया हो.
गड़बड़ी कोड
नीचे दी गई टेबल में आम तौर पर मिलने वाले गड़बड़ी कोड की सूची दी गई है. साथ ही, उनकी वजहों और समस्या हल करने के तरीकों की जानकारी दी गई है:
| एचटीटीपी कोड | Status | जानकारी | समाधान |
| 400 | INVALID_ARGUMENT | अनुरोध का मुख्य हिस्सा गलत है. | अनुरोध के फ़ॉर्मैट, उदाहरण, और इस्तेमाल किए जा सकने वाले वर्शन के लिए, एपीआई का रेफ़रंस देखें. एपीआई के नए वर्शन की सुविधाओं का इस्तेमाल, पुराने एंडपॉइंट के साथ करने से गड़बड़ियां हो सकती हैं. |
| 403 | PERMISSION_DENIED | आपकी एपीआई कुंजी के पास ज़रूरी अनुमतियां नहीं हैं. | पक्का करें कि आपकी एपीआई कुंजी सेट हो और उसके पास सही ऐक्सेस हो. |
| 404 | NOT_FOUND | अनुरोध किया गया संसाधन नहीं मिला. | देखें कि आपके एपीआई वर्शन के लिए, आपके अनुरोध में मौजूद सभी पैरामीटर मान्य हैं या नहीं. |
| 429 | RESOURCE_EXHAUSTED | आपने अनुरोधों की तय सीमा पार कर ली है. | पक्का करें कि आप मॉडल की दर सीमा के अंदर हैं. अगर ज़रूरी हो, तो कोटा बढ़ाने का अनुरोध करें. |
| 500 | आंतरिक | Google की ओर से कोई गड़बड़ी हुई. | थोड़ी देर इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो Google AI Studio में सुझाव/राय दें या शिकायत करें बटन का इस्तेमाल करके इसकी शिकायत करें. |
| 503 | हवा की क्वालिटी की जानकारी उपलब्ध नहीं है | यह सेवा कुछ समय के लिए ओवरलोड या बंद हो सकती है. | थोड़ी देर इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो Google AI Studio में सुझाव/राय दें या शिकायत करें बटन का इस्तेमाल करके इसकी शिकायत करें. |
मॉडल पैरामीटर की गड़बड़ियों के लिए अपने एपीआई कॉल की जांच करना
पक्का करें कि आपके मॉडल पैरामीटर इन वैल्यू के अंदर हों:
| मॉडल पैरामीटर | वैल्यू (range) |
| उम्मीदवारों की संख्या | 1-8 (इंटीजर) |
| तापमान | 0.0 से 1.0 |
| ज़्यादा से ज़्यादा आउटपुट टोकन |
जिस मॉडल का इस्तेमाल किया जा रहा है उसके लिए ज़्यादा से ज़्यादा टोकन की संख्या तय करने के लिए,
get_model (Python)
का इस्तेमाल करें.
|
| TopP | 0.0 से 1.0 |
पैरामीटर वैल्यू की जांच करने के अलावा, पक्का करें कि
सही एपीआई वर्शन का इस्तेमाल किया जा रहा हो (उदाहरण के लिए, /v1 या /v1beta) और
ऐसा मॉडल जो आपकी ज़रूरत के हिसाब से काम करता हो. उदाहरण के लिए, अगर कोई सुविधा बीटा वर्शन में है, तो वह सिर्फ़ /v1beta एपीआई वर्शन में उपलब्ध होगी.
यह देखना कि आपके पास सही मॉडल है या नहीं
पक्का करें कि ऐप्लिकेशन के साथ काम करने वाला मॉडल इस्तेमाल किया जा रहा हो. इस्तेमाल के लिए उपलब्ध सभी मॉडल पाने के लिए, list_models (Python) का इस्तेमाल करें.
सुरक्षा से जुड़ी समस्याएं
अगर एपीआई कॉल में सुरक्षा सेटिंग की वजह से किसी प्रॉम्प्ट को ब्लॉक किया गया है, तो एपीआई कॉल में सेट किए गए फ़िल्टर के हिसाब से उस प्रॉम्प्ट को देखें.
अगर आपको BlockedReason.OTHER दिखता है, तो हो सकता है कि क्वेरी या जवाब सेवा की शर्तों का उल्लंघन करता हो या काम न करता हो.
मॉडल आउटपुट को बेहतर बनाएं
बेहतर क्वालिटी वाले मॉडल के आउटपुट के लिए, ज़्यादा स्ट्रक्चर्ड प्रॉम्प्ट लिखें. प्रॉम्प्ट डिज़ाइन की जानकारी वाले पेज पर, कुछ बुनियादी कॉन्सेप्ट, रणनीतियों, और सबसे सही तरीकों के बारे में बताया गया है.
अगर आपके पास अच्छे इनपुट/आउटपुट पेयर के सैकड़ों उदाहरण हैं, तो मॉडल ट्यूनिंग का भी इस्तेमाल किया जा सकता है.
टोकन की सीमाओं के बारे में जानकारी
मॉडल के बारे में अतिरिक्त मेटाडेटा पाने के लिए, ModelService API का इस्तेमाल करें. इसमें इनपुट और आउटपुट टोकन की सीमाओं की जानकारी भी शामिल है.
अपने प्रॉम्प्ट में इस्तेमाल किए गए टोकन पाने के लिए, चैट मॉडल के लिए countMessageTokens और टेक्स्ट मॉडल के लिए countTextTokens का इस्तेमाल करें.
पहले से मालूम समस्याएं
- Google AI Studio के लिए मोबाइल पर सहायता: हालांकि, वेबसाइट को मोबाइल पर खोला जा सकता है, लेकिन इसे छोटी स्क्रीन के लिए ऑप्टिमाइज़ नहीं किया गया है.
- यह एपीआई सिर्फ़ अंग्रेज़ी में काम करता है. अलग-अलग भाषाओं में प्रॉम्प्ट सबमिट करने पर, ऐसे जवाब मिल सकते हैं जिनके बारे में अनुमान नहीं है या ब्लॉक है. अपडेट के लिए उपलब्ध भाषाएं देखें.
बग दायर करें
सवाल पूछने या सुविधा का अनुरोध करने या बग सबमिट करने के लिए, GitHub में समस्या दर्ज करें.