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

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

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

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

एचटीटीपी कोड स्टेटस ब्यौरा उदाहरण समाधान
400 INVALID_ARGUMENT अनुरोध का मुख्य हिस्सा गलत है. आपके अनुरोध में टाइपिंग की कोई गड़बड़ी है या कोई ज़रूरी फ़ील्ड मौजूद नहीं है. अनुरोध के फ़ॉर्मैट, उदाहरणों, और इस्तेमाल किए जा सकने वाले वर्शन के बारे में जानने के लिए, एपीआई का संदर्भ देखें. नए एपीआई वर्शन की सुविधाओं को पुराने एंडपॉइंट के साथ इस्तेमाल करने पर गड़बड़ियां हो सकती हैं.
400 FAILED_PRECONDITION आपके देश में Gemini API का मुफ़्त टियर उपलब्ध नहीं है. कृपया Google AI Studio में अपने प्रोजेक्ट के लिए बिलिंग की सुविधा चालू करें. आपने ऐसे इलाके से अनुरोध किया है जहां बिना शुल्क वाली सेवा उपलब्ध नहीं है. साथ ही, आपने Google AI Studio में अपने प्रोजेक्ट के लिए बिलिंग की सुविधा चालू नहीं की है. Gemini API का इस्तेमाल करने के लिए, आपको Google AI Studio का इस्तेमाल करके, पेड प्लान सेटअप करना होगा.
402 RESOURCE_EXHAUSTED आपका प्रीपेड क्रेडिट बैलेंस खत्म हो गया है. आपके बिलिंग खाते में प्रीपेड क्रेडिट खत्म हो गए हैं. इसलिए, उस बिलिंग खाते से लिंक किए गए सभी एपीआई पासकोड काम नहीं कर रहे हैं. अपने बिलिंग खाते में क्रेडिट जोड़ें या ऑटो-रीलोड की सुविधा चालू करें. इस अनुरोध को फिर से न भेजें: क्रेडिट जोड़े जाने तक यह पूरा नहीं होगा.
403 PERMISSION_DENIED आपके एपीआई पासकोड के पास ज़रूरी अनुमतियां नहीं हैं. आपने गलत एपीआई पासकोड का इस्तेमाल किया है. आपने पुष्टि करने की सही प्रोसेस पूरी किए बिना, ट्यून किए गए मॉडल का इस्तेमाल करने की कोशिश की है. देखें कि आपका एपीआई पासकोड सेट हो और उसके पास सही ऐक्सेस हो. साथ ही, ट्यून किए गए मॉडल का इस्तेमाल करने के लिए, पुष्टि करने की प्रोसेस पूरी करना न भूलें.
404 NOT_FOUND अनुरोध किया गया संसाधन नहीं मिला. आपकी अनुरोध की गई इमेज, ऑडियो या वीडियो फ़ाइल नहीं मिली. देखें कि आपके अनुरोध में शामिल सभी पैरामीटर, आपके एपीआई वर्शन के लिए मान्य हैं या नहीं.
429 RESOURCE_EXHAUSTED आपने एपीआई की किसी एक दर की सीमा (आरपीएम, टीपीएम, आरपीडी, खर्च वगैरह) को पार कर लिया है. आपने बहुत ज़्यादा अनुरोध भेजे हैं, बहुत ज़्यादा टोकन इस्तेमाल किए हैं या अपने खाते के बिलिंग इतिहास और टियर के लिए, खर्च के आधार पर तय की गई सीमाओं को पार कर लिया है. पुष्टि करें कि आप मॉडल की रेट लिमिट के अंदर हों. कुछ देर इंतज़ार करें और फिर से कोशिश करें. अनुरोधों की दर या साइज़ कम करें. अगर ज़रूरत हो, तो अनुरोधों की संख्या बढ़ाने का अनुरोध करें.
499 रद्द कर दी गई कार्रवाई रद्द कर दी गई थी. आम तौर पर, ऐसा कॉल करने वाला व्यक्ति करता है. एपीआई के जवाब देने की प्रोसेस पूरी होने से पहले ही क्लाइंट ने कनेक्शन बंद कर दिया. देखें कि आपका क्लाइंट या नेटवर्क इंफ़्रास्ट्रक्चर, कनेक्शन को समय से पहले बंद तो नहीं कर रहा है. उदाहरण के लिए, क्लाइंट-साइड टाइमआउट की वजह से.
500 INTERNAL Google की तरफ़ से कोई गड़बड़ी हुई. आपने बहुत ज़्यादा कॉन्टेक्स्ट दिया है. अगर कोई समस्या आ रही है, तो Gemini API के स्टेटस पेज पर जाकर देखें. इनपुट कॉन्टेक्स्ट को कम करें या कुछ समय के लिए किसी दूसरे मॉडल पर स्विच करें.उदाहरण के लिए, Gemini 2. 5 Pro से Gemini 2.5 Flash पर स्विच करें.इसके बाद, देखें कि समस्या ठीक हुई या नहीं. इसके अलावा, थोड़ी देर बाद फिर से अनुरोध करें. अगर दोबारा कोशिश करने के बाद भी समस्या बनी रहती है, तो कृपया Google AI Studio में सुझाव/राय भेजें या शिकायत करें बटन का इस्तेमाल करके इसकी शिकायत करें.
503 हवा की क्वालिटी की जानकारी उपलब्ध नहीं है ऐसा हो सकता है कि सेवा पर कुछ समय के लिए बहुत ज़्यादा लोड हो या वह काम न कर रही हो. यह सेवा कुछ समय के लिए उपलब्ध नहीं है. अगर कोई समस्या आ रही है, तो 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.

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