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

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

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

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

कोड एचटीटीपी स्टेटस ब्यौरा सुझाई गई कार्रवाई
invalid_request 400 खराब अनुरोध अनुरोध का पेलोड गलत है या इसमें अमान्य पैरामीटर शामिल हैं. एपीआई के रेफ़रंस के हिसाब से, अपने अनुरोध के सिंटैक्स और पैरामीटर की जांच करें.
failed_precondition 400 खराब अनुरोध अनुरोध को प्रोसेस नहीं किया जा सकता, क्योंकि ज़रूरी शर्त पूरी नहीं हुई है. जैसे, बिलिंग की सुविधा बंद है. प्रोजेक्ट के बिलिंग स्टेटस या खाते की ज़रूरी शर्तों की पुष्टि करें.
out_of_range 416 अनुरोध की गई सीमा, सर्वर के हिसाब से नहीं है अनुरोध का पैरामीटर, मान्य सीमा से बाहर है. पैरामीटर की वैल्यू और सीमाओं की जांच करें.
parameter_unknown 400 खराब अनुरोध अनुरोध में कोई ऐसा पैरामीटर शामिल है जिसके बारे में जानकारी नहीं है. जिस पैरामीटर के बारे में जानकारी नहीं है उसे हटाएं और फिर से कोशिश करें.
authentication 401 कोड वाली गड़बड़ी: अनुमति नहीं है एपीआई पासकोड मौजूद नहीं है, अमान्य है या उसकी समयसीमा खत्म हो गई है. अपने एपीआई पासकोड की पुष्टि करें.
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) के लिए, एपीआई, सर्वर-सेंड इवेंट (एसएसई) स्ट्रीम पर गड़बड़ी के इवेंट भेजता है. इसमें event_type को "error" पर सेट किया जाता है. error फ़ील्ड में, code और message का वही स्ट्रक्चर होता है:

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

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

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