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

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

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

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

कोड एचटीटीपी स्टेटस ब्यौरा सुझाई गई कार्रवाई
invalid_request 400 खराब अनुरोध अनुरोध का पेलोड गलत है या उसमें अमान्य पैरामीटर हैं. एपीआई के संदर्भ के हिसाब से, अपने अनुरोध के सिंटैक्स और पैरामीटर की जांच करें.
failed_precondition 400 खराब अनुरोध अनुरोध को प्रोसेस नहीं किया जा सकता, क्योंकि ज़रूरी शर्त पूरी नहीं की गई है. उदाहरण के लिए, बिलिंग की सुविधा बंद है. प्रोजेक्ट की बिलिंग स्थिति या खाते से जुड़ी ज़रूरी शर्तों की पुष्टि करें.
out_of_range 416 Requested Range Not Satisfiable अनुरोध का पैरामीटर, मान्य रेंज से बाहर है. पैरामीटर की वैल्यू और सीमाएं देखें.
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 Too Many Requests आपने हर मिनट या हर सेकंड के लिए तय की गई अनुरोध या टोकन की सीमा पार कर ली है. इंतज़ार करें और एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
quota_exceeded 429 Too Many Requests आपने हर दिन के लिए तय कोटा पार कर लिया है. कोटा रीसेट होने तक इंतज़ार करें या कोटा बढ़ाने का अनुरोध करें.
too_many_requests 429 Too Many Requests आपने कम समय में बहुत ज़्यादा अनुरोध किए हैं. इंतज़ार करें और एक्स्पोनेंशियल बैकऑफ़ के साथ फिर से कोशिश करें.
cancelled 499 Client Closed Request क्लाइंट ने अनुरोध पूरा होने से पहले ही उसे रद्द कर दिया. आपको कुछ करने की ज़रूरत नहीं है. आम तौर पर, इसका मतलब है कि क्लाइंट डिसकनेक्ट हो गया है.
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 का रेफ़रंस देखें.

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