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

इस पेज पर, 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.

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