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

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

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

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

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

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

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

कोड ब्यौरा
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 का रेफ़रंस देखें.

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