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

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

स्टैंडर्ड एपीआई के गड़बड़ी कोड

अनुरोध के लेवल पर होने वाली ये सामान्य गड़बड़ियां, स्टैंडर्ड एचटीटीपी स्टेटस कोड से मेल खाती हैं. गड़बड़ियों को प्रोग्राम के हिसाब से ठीक करने के लिए, अपने ऐप्लिकेशन लॉजिक में code फ़ील्ड का इस्तेमाल करें.

कोड एचटीटीपी स्टेटस ब्यौरा सुझाई गई कार्रवाई
invalid_request 400 खराब अनुरोध अनुरोध पेलोड गलत है या इसमें अमान्य पैरामीटर शामिल हैं. एपीआई का संदर्भ देखकर, अपने अनुरोध के सिंटैक्स और पैरामीटर की जांच करें.
failed_precondition 400 खराब अनुरोध अनुरोध को प्रोसेस नहीं किया जा सकता, क्योंकि ज़रूरी शर्तें पूरी नहीं की गई हैं. उदाहरण के लिए, बिलिंग की सुविधा बंद है. प्रोजेक्ट के बिलिंग स्टेटस या खाते की ज़रूरी शर्तों की पुष्टि करें.
out_of_range 416 अनुरोध की गई सीमा, सर्वर के हिसाब से नहीं है अनुरोध पैरामीटर, मान्य सीमा से बाहर है. पैरामीटर की वैल्यू और सीमाएं देखें.
parameter_unknown 400 खराब अनुरोध अनुरोध में ऐसा पैरामीटर शामिल है जिसके बारे में जानकारी नहीं है. जिस पैरामीटर की पहचान नहीं हो पाई है उसे हटाएं और फिर से कोशिश करें.
authentication 401 कोड वाली गड़बड़ी: अनुमति नहीं है एपीआई पासकोड मौजूद नहीं है, अमान्य है या इसकी समयसीमा खत्म हो गई है. अपने एपीआई पासकोड की पुष्टि करें.
payment_required 402 भुगतान आवश्यक आपका प्रीपेड क्रेडिट बैलेंस खत्म हो गया है. अपने बिलिंग खाते में क्रेडिट जोड़ें या ऑटो-रीलोड की सुविधा चालू करें. फिर से कोशिश न करें: क्रेडिट जोड़े जाने तक अनुरोध पूरा नहीं होगा.
permission_denied 403 निषिद्ध आपकी एपीआई पासकोड के पास इस संसाधन के लिए अनुमति नहीं है. अपनी एपीआई कुंजी की अनुमतियों और प्रोजेक्ट के ऐक्सेस की जांच करें.
not_found पेज नहीं मिला अनुरोध किया गया संसाधन नहीं मिला. संसाधन के पाथ और पैरामीटर की पुष्टि करें.
model_not_found पेज नहीं मिला बताया गया मॉडल नहीं मिला. मॉडल के नाम की पुष्टि करें या किसी दूसरे मॉडल पर वापस जाएं.
already_exists 409 विरोधाभास आपने जिस इकाई को बनाने की कोशिश की है वह पहले से मौजूद है. फिर से बनाने से पहले, देखें कि संसाधन पहले से मौजूद है या नहीं.
aborted 409 विरोधाभास कॉन्फ़्लिक्ट या कॉंकुरेंसी की जांच पूरी न होने की वजह से, कार्रवाई को बीच में ही रद्द कर दिया गया. ऐप्लिकेशन के बड़े लेवल पर अनुरोध फिर से करें.
rate_limit_exceeded 429 कई बार अनुरोध किया गया आपने हर मिनट या हर सेकंड के अनुरोध या टोकन की सीमा पार कर ली है. इंतज़ार करें और एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
quota_exceeded 429 कई बार अनुरोध किया गया आपने एक दिन में मैसेज को मंज़ूरी देने की तय सीमा पूरी कर ली है. कोटा रीसेट होने का इंतज़ार करें या कोटा बढ़ाने का अनुरोध करें.
too_many_requests 429 कई बार अनुरोध किया गया आपने कम समय में बहुत ज़्यादा अनुरोध किए हैं. इंतज़ार करें और एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
cancelled 499 अनुरोध की प्रोसेस होने के दौरान क्लाइंट ने कनेक्शन बंद कर दिया क्लाइंट ने अनुरोध पूरा होने से पहले ही उसे रद्द कर दिया. कुछ करने की ज़रूरत नहीं है. आम तौर पर, इसका मतलब है कि क्लाइंट डिसकनेक्ट हो गया है.
api_error 500 सर्वर में गड़बड़ी सर्वर पर अचानक कोई गड़बड़ी हुई. अनुरोध को फिर से भेजें. अगर समस्या बनी रहती है, तो सहायता टीम से संपर्क करें.
unimplemented 501 कार्यान्वित नहीं यह सुविधा या कार्रवाई लागू नहीं की गई है या यह काम नहीं करती. एपीआई की सुविधाओं की जांच करें या ऐसी सुविधा पर स्विच करें जो काम करती हो.
service_unavailable 503 कोड वाली गड़बड़ी: सेवा उपलब्ध नहीं है यह सेवा कुछ समय के लिए उपलब्ध नहीं है या इस पर बहुत ज़्यादा लोड है. इंतज़ार करें और एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
deadline_exceeded 504 कोड वाली गड़बड़ी: गेटवे का समय खत्म हो गया है अनुरोध तय समयसीमा में पूरा नहीं हुआ. सर्वर के डिफ़ॉल्ट समय का इस्तेमाल करने के लिए, क्लाइंट की समयसीमा की सेटिंग हटाएं या बढ़ाएं.

जनरेट किए गए कोड ब्लॉक किए गए

इन गड़बड़ी कोड से पता चलता है कि नीति, सुरक्षा या कॉन्टेंट पर पाबंदियों की वजह से, मॉडल का आउटपुट ब्लॉक कर दिया गया है. इनमें से कोई कोड मिलने पर, अपने इनपुट में बदलाव करें और फिर से कोशिश करें.

कोड ब्यौरा
safety सुरक्षा से जुड़े उल्लंघनों (नुकसान पहुंचाने वाला कॉन्टेंट) की वजह से अनुरोध को ब्लॉक कर दिया गया.
recitation कॉपीराइट या कविता पढ़ने से जुड़ी पाबंदियों की वजह से, अनुरोध को ब्लॉक कर दिया गया है.
language अनुरोध की गई भाषा उपलब्ध न होने की वजह से, अनुरोध को ब्लॉक कर दिया गया है.
prohibited_content पाबंदी वाले कॉन्टेंट से जुड़े दिशा-निर्देशों के उल्लंघन की वजह से, अनुरोध को पूरा नहीं किया जा सका.
spii व्यक्तिगत पहचान ज़ाहिर करने वाली संवेदनशील जानकारी से जुड़ी पाबंदियों की वजह से, अनुरोध को ब्लॉक कर दिया गया.
blocklist ब्लॉकलिस्ट में शामिल पाबंदी वाले शब्दों की वजह से अनुरोध ब्लॉक कर दिया गया.
image_safety सुरक्षा से जुड़े उल्लंघन की वजह से, इमेज जनरेट करने की सुविधा ब्लॉक कर दी गई है.
image_prohibited_content पाबंदी वाले कॉन्टेंट से जुड़े दिशा-निर्देशों का उल्लंघन करने की वजह से, इमेज जनरेट करने की सुविधा ब्लॉक कर दी गई है.
image_recitation कॉपीराइट या कविता पढ़ने से जुड़ी पाबंदियों की वजह से, इमेज जनरेट करने की सुविधा ब्लॉक कर दी गई है.
image_other इमेज जनरेट करने की सुविधा को कुछ वजहों से ब्लॉक कर दिया गया है.
content_blocked नीति से जुड़ी किसी वजह से अनुरोध को ब्लॉक कर दिया गया है.

जनरेट करने से जुड़ी गड़बड़ी के कोड

इन गड़बड़ी कोड से पता चलता है कि मॉडल के जनरेट किए गए आउटपुट में कोई स्ट्रक्चरल समस्या है. जैसे, फ़ंक्शन कॉल का गलत फ़ॉर्मैट या टूल कॉल का एलान न किया जाना.

कोड ब्यौरा
malformed_function_call मॉडल ने एक ऐसा फ़ंक्शन कॉल जनरेट किया है जिसे पार्स नहीं किया जा सका.
malformed_tool_call मॉडल ने एक ऐसा टूल कॉल जनरेट किया है जिसे पार्स नहीं किया जा सका.
unexpected_tool_call मॉडल ने ऐसे टूल को कॉल किया है जिसके बारे में अनुरोध में नहीं बताया गया था.
no_image मॉडल, इमेज जनरेट नहीं कर सका.
too_many_tool_calls मॉडल ने तय सीमा से ज़्यादा टूल कॉल जनरेट किए.
missing_thought_signature जवाब में, ज़रूरी थॉट सिग्नेचर मौजूद नहीं है.

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

Interactions API से मिलने वाली सभी गड़बड़ियों में, error ऑब्जेक्ट दिखता है. इसमें code और message शामिल होता है. उदाहरण के लिए, काम न करने वाले टूल टाइप को पास करने पर, यह नतीजा मिलता है:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'. Supported values: 'function', 'code_execution', 'mcp_server', 'filesystem', 'google_maps', 'google_search', 'bash', 'computer_use', 'file_search', 'url_context'."
  }
}
फ़ील्ड टाइप ब्यौरा
code स्ट्रिंग snake_case में मशीन के पढ़ने लायक गड़बड़ी का कोड.
message स्ट्रिंग इस स्ट्रिंग में, गड़बड़ी के बारे में ऐसी जानकारी होती है जिसे कोई भी व्यक्ति आसानी से पढ़ सकता है.

गड़बड़ियों की जानकारी कैसे दी जाती है

एपीआई, गड़बड़ियों को अलग-अलग तरीके से दिखाता है. यह इस बात पर निर्भर करता है कि आपने स्टैंडर्ड एचटीटीपी अनुरोध किया है या स्ट्रीमिंग (एसएसई) अनुरोध.

स्टैंडर्ड एचटीटीपी अनुरोध

स्टैंडर्ड (नॉन-स्ट्रीमिंग) अनुरोधों के लिए, एपीआई एचटीटीपी रिस्पॉन्स वाला स्टेटस कोड (जैसे, 400 Bad Request, 401 Unauthorized या 429 Too Many Requests) सेट करता है. साथ ही, JSON रिस्पॉन्स बॉडी में error ऑब्जेक्ट दिखाता है:

{
  "error": {
    "code": "invalid_request",
    "message": "The value 'invalid_tool_type_xyz' is not supported for 'type' at 'tools[0]'."
  }
}

स्ट्रीमिंग (एसएसई) के अनुरोध

स्ट्रीमिंग के अनुरोधों (stream: true) के लिए, एपीआई, Server-Sent Events (SSE) स्ट्रीम पर गड़बड़ी वाले इवेंट भेजता है. इसमें event_type को "error" पर सेट किया जाता है. error फ़ील्ड में, code और message का एक जैसा स्ट्रक्चर होता है:

{
  "event_type": "error",
  "error": {
    "code": "not_found",
    "message": "Failed to get completed interaction: Result not found."
  }
}

एसएसई इवेंट के पूरे स्कीमा के लिए, Interactions API का रेफ़रंस देखें.

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