एपीआई से जुड़ी गड़बड़ियां

इस पेज पर, GenerateContent API से मिलने वाले बैकएंड गड़बड़ी के कोड के बारे में जानकारी दी गई है. साथ ही, इसमें gRPC गड़बड़ी के जवाब के फ़ॉर्मैट और समस्या हल करने के चरणों के बारे में बताया गया है.

एचटीटीपी गड़बड़ी के कोड

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

एचटीटीपी कोड स्टेटस ब्यौरा उदाहरण सॉल्यूशन
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 आपने एपीआई की दर से जुड़ी किसी एक सीमा (आरपीएम, टीपीएम, आरपीडी, खर्च वगैरह) को पार कर लिया है. आपने बहुत ज़्यादा अनुरोध भेजे हैं, बहुत ज़्यादा टोकन का इस्तेमाल किया है या अपने खाते के बिलिंग इतिहास और टियर के लिए, खर्च पर आधारित सीमाओं को पार कर लिया है. पुष्टि करें कि आपने मॉडल की दर से जुड़ी सीमाओं के अंदर ही अनुरोध भेजे हैं. कुछ समय इंतज़ार करें और फिर से कोशिश करें. अपने अनुरोधों की दर या साइज़ कम करें. अगर ज़रूरत हो, तो दर से जुड़ी सीमा बढ़ाने का अनुरोध करें.
499 CANCELLED कार्रवाई रद्द कर दी गई. आम तौर पर, ऐसा कॉल करने वाले व्यक्ति की वजह से होता है. एपीआई के जवाब देने से पहले ही, क्लाइंट ने कनेक्शन बंद कर दिया. देखें कि आपका क्लाइंट या नेटवर्क इन्फ़्रास्ट्रक्चर, कनेक्शन को समय से पहले तो बंद नहीं कर रहा है. जैसे, क्लाइंट-साइड टाइम आउट की वजह से.
500 INTERNAL Google की तरफ़ से कोई गड़बड़ी हुई. आपका इनपुट कॉन्टेक्स्ट बहुत लंबा है. किसी भी तरह की समस्या के बारे में जानने के लिए, Gemini API के स्टेटस पेज पर जाएं. अपना इनपुट कॉन्टेक्स्ट कम करें या कुछ समय के लिए किसी दूसरे मॉडल पर स्विच करें. जैसे, Gemini 2.5 Pro से Gemini 2.5 Flash पर स्विच करें और देखें कि यह काम करता है या नहीं. इसके अलावा, कुछ समय इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो कृपया Google AI Studio में सुझाव/राय भेजें या शिकायत करें बटन का इस्तेमाल करके, इसकी शिकायत करें.
503 UNAVAILABLE शायद सेवा पर कुछ समय के लिए बहुत ज़्यादा लोड हो या वह डाउन हो. फ़िलहाल, सेवा की क्षमता खत्म हो रही है. किसी भी तरह की समस्या के बारे में जानने के लिए, Gemini API के स्टेटस पेज पर जाएं. कुछ समय के लिए किसी दूसरे मॉडल पर स्विच करें. जैसे, Gemini 2.5 Pro से Gemini 2.5 Flash पर स्विच करें और देखें कि यह काम करता है या नहीं. इसके अलावा, कुछ समय इंतज़ार करें और फिर से अनुरोध करें. अगर फिर से कोशिश करने के बाद भी समस्या बनी रहती है, तो कृपया Google AI Studio में सुझाव/राय भेजें या शिकायत करें बटन का इस्तेमाल करके, इसकी शिकायत करें.
504 DEADLINE_EXCEEDED सेवा, तय समय में प्रोसेस पूरी नहीं कर पा रही है. आपका प्रॉम्प्ट (या कॉन्टेक्स्ट) इतना बड़ा है कि उसे समय पर प्रोसेस नहीं किया जा सकता. इस गड़बड़ी से बचने के लिए, अपने क्लाइंट के अनुरोध में 'टाइम आउट' की ज़्यादा वैल्यू सेट करें.

गड़बड़ी के जवाब का फ़ॉर्मैट

जब GenerateContent का कोई अनुरोध पूरा नहीं होता है, तो एपीआई, एचटीटीपी स्टेटस कोड सेट करता है. जैसे, 400 Bad Request, 403 Forbidden या 429 Too Many Requests. साथ ही, gRPC स्टेटस की जानकारी वाला JSON जवाब का मुख्य हिस्सा दिखाता है:

{
  "error": {
    "code": 400,
    "message": "API key not valid. Please pass a valid API key.",
    "status": "INVALID_ARGUMENT",
    "details": [
      {
        "@type": "type.googleapis.com/google.rpc.ErrorInfo",
        "reason": "API_KEY_INVALID",
        "domain": "googleapis.com",
        "metadata": {
          "service": "generativelanguage.googleapis.com"
        }
      },
      {
        "@type": "type.googleapis.com/google.rpc.LocalizedMessage",
        "locale": "en-US",
        "message": "API key not valid. Please pass a valid API key."
      }
    ]
  }
}
फ़ील्ड टाइप ब्यौरा
code पूर्णांक एचटीटीपी स्टेटस कोड.
message स्ट्रिंग गड़बड़ी के बारे में ऐसी जानकारी जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.
status स्ट्रिंग SCREAMING_CASE में gRPC स्टेटस कोड.
details अरे गड़बड़ी के बारे में अतिरिक्त जानकारी. जैसे, ErrorInfo या LocalizedMessage.

आगे क्या करना है