त्रुटियाँ

VIDIO API एक सुसंगत त्रुटि वस्तु प्रारूप का उपयोग करता है। इस पृष्ठ का उपयोग सामान्य त्रुटि प्रकारों, HTTP स्थिति कोडों और API द्वारा लौटाए गए उदाहरण संदेशों को समझने के लिए करें।

एपीआई एक्सेस वर्तमान में स्टूडियो योजना और इससे ऊपर के लिए उपलब्ध है।

अवलोकन

जब कोई अनुरोध विफल होता है, तो VIDIO API एक त्रुटि वस्तु के साथ प्रकार और संदेश लौटाता है। कुछ त्रुटियाँ विफलता को समझाने में मदद करने के लिए अतिरिक्त क्षेत्रों को भी शामिल कर सकती हैं।

त्रुटि प्रारूप

json
{ "error": { "type": "invalid_request_error", "message": "नौकरी नहीं मिली" } }

त्रुटि संदर्भ

StatusTypeMessageDescription
400invalid_request_errorupload URL अनुरोध में आवश्यक query पैरामीटर गायब हैंजब upload URL अनुरोध से आवश्यक query पैरामीटर गायब हों तो लौटाया जाता है।
400invalid_request_errorjob_id गायब हैजब render अनुरोध में job ID शामिल न हो तो लौटाया जाता है।
400invalid_request_errorइस job के लिए कोई आउटपुट उपलब्ध नहीं हैजब job के पास कोई रेंडर करने योग्य आउटपुट नहीं होते तो लौटाया जाता है।
400invalid_request_errorinput_keys एक खाली न होने वाला array होना चाहिएजब `input_keys` गायब हो या खाली हो तो लौटाया जाता है।
400invalid_request_errorinput_keys में कम से कम एक मान्य input key होना चाहिएजब normalize करने के बाद सभी दिए गए input keys खाली या अमान्य हों तो लौटाया जाता है।
400input_duration_requirement_errorकुल इनपुट अवधि 2 सेकंड से अधिक होनी चाहिएजब सभी इनपुट मीडिया की संयुक्त अवधि 2 सेकंड या उससे कम हो तब लौटाया जाता है।
400input_duration_requirement_errorकुल इनपुट अवधि 6 घंटे से कम होनी चाहिएजब सभी इनपुट मीडिया की संयुक्त अवधि 6 घंटे या उससे अधिक हो तब लौटाया जाता है।
400input_image_count_requirement_errorइनपुट छवियों की संख्या 4000 से अधिक नहीं होनी चाहिएजब इनपुट छवियों की संख्या अनुमति दी गई अधिकतम सीमा 4000 से अधिक हो तो लौटाया जाता है।
400input_video_count_requirement_errorइनपुट वीडियो की संख्या 400 से अधिक नहीं होनी चाहिएजब इनपुट वीडियो की संख्या अनुमति दी गई अधिकतम सीमा 400 से अधिक हो तो लौटाया जाता है।
400invalid_request_errorअमान्य video_category। अनुमत मान: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, othersजब `video_category` समर्थित नहीं होता तो लौटाया जाता है।
400invalid_request_errorअमान्य aspect_ratio। अनुमत मान: square, portrait, landscapeजब `aspect_ratio` समर्थित नहीं होता तो लौटाया जाता है।
400invalid_request_erroroutput_length एक धनात्मक संख्या होनी चाहिएजब `output_length` गायब, शून्य, या नकारात्मक हो तो लौटाया जाता है।
400invalid_request_errorinput_keys मेटाडेटा से सकारात्मक इनपुट अवधि निर्धारित नहीं की जा सकतीजब API अपलोड किए गए इनपुट्स के लिए वैध अवधि निर्धारित नहीं कर पाती तो लौटाया जाता है।
400invalid_request_errormusic_volume 0 से 100 के बीच एक संख्या होनी चाहिएजब `music_volume` प्रदान किया गया हो पर वह 0 से 100 के बीच वैध संख्या न हो तो लौटाया जाता है।
400invalid_request_errororiginal_audio_volume 0 से 100 के बीच एक संख्या होनी चाहिएजब `original_audio_volume` प्रदान किया गया हो पर वह 0 से 100 के बीच वैध संख्या न हो तो लौटाया जाता है।
400invalid_request_errorअमान्य music_category। अनुमत मान: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogsजब `music_category` प्रदान किया गया हो लेकिन यह समर्थित संगीत श्रेणियों में से किसी से मेल नहीं खाता तो लौटाया जाता है।
401authentication_errorAPI key गायब हैजब `x-api-key` हेडर प्रदान नहीं किया गया हो तो लौटाया जाता है।
401authentication_errorअमान्य API keyजब प्रदान किया गया API key किसी सक्रिय key से मेल नहीं खाता तो लौटाया जाता है।
402insufficient_balanceइस job को प्रोसेस करने के लिए आपके पास पर्याप्त क्रेडिट नहीं हैंजब खाते में प्रोसेसिंग या रेंडरिंग के लिए पर्याप्त क्रेडिट न हों तो लौटाया जाता है।
403permission_errorआपको इस job तक पहुँचने की अनुमति नहीं हैजब प्रमाणीकरण किया गया उपयोगकर्ता अनुरोधित job का मालिक नहीं होता तो लौटाया जाता है।
403permission_errorइस job को रेंडर करने की आपको अनुमति नहीं हैजब प्रमाणीकरण किया गया उपयोगकर्ता उस job का मालिक नहीं होता जिसे रेंडर किया जा रहा हो तो लौटाया जाता है।
404invalid_request_errorJob नहीं मिलाजब अनुरोधित job अस्तित्व में नहीं होता तो लौटाया जाता है।
404invalid_request_errorUser नहीं मिलाजब प्रमाणीकरण किए गए उपयोगकर्ता का रिकॉर्ड नहीं मिल पाता तो लौटाया जाता है।
429rate_limit_errorअनुरोध बहुत अधिक हैंजब क्लाइंट एंडपॉइंट के लिए अनुमत अनुरोध दर को पार कर देता है तो लौटाया जाता है। वर्तमान सीमा प्रति मिनट 60 अनुरोध है। दर-सीमांकन मुख्य रूप से x-api-key हेडर के आधार पर प्रति API key लागू किया जाता है, और जब API key मौजूद नहीं होता तो यह क्लाइंट IP पते पर निर्भर करता है। जो क्लाइंट इस सीमा को छूते हैं उन्हें अनुरोध की आवृत्ति कम करनी चाहिए और दर-सीमा विंडो रीसेट होने के बाद पुनः प्रयास करना चाहिए।
429rate_limit_errorआपके पास पहले से ही 10 चल रहे या कतारबद्ध jobs हैं, जो अधिकतम अनुमत हैं। कृपया नया सबमिट करने से पहले कुछ jobs के समाप्त होने का इंतज़ार करें।जब उपयोगकर्ता के पास सर्वरों पर चल रहे jobs और कतार में पेंडिंग jobs दोनों में ही अधिकतम अनुमत संख्या से अधिक इन-प्रोग्रेस jobs हों तो लौटाया जाता है। वर्तमान सीमा प्रति उपयोगकर्ता कुल 10 चल रहे या कतारबद्ध jobs है। स्वामित्व यह निर्धारित करके किया जाता है कि busy servers और पेंडिंग कतार प्रविष्टियों पर प्रत्येक job_id मेल खाता है या नहीं और उसे job के user_email से मिलाया जाता है। जो क्लाइंट इस सीमा पर पहुंचते हैं उन्हें एक या अधिक मौजूदा jobs के पूरा होने का इंतज़ार करना चाहिए इससे पहले कि वे नया job बनाएं या रेंडर करें।
500api_errorप्रमाणीकरण त्रुटिजब सर्वर पर API key प्रमाणीकरण अप्रत्याशित रूप से विफल हो जाए तो लौटाया जाता है।
500api_errorअंतर्निहित सर्वर त्रुटिजब status, render, या highlight reel एंडपॉइंट्स में अप्रत्याशित सर्वर-साइड विफलताएँ हों तो लौटाया जाता है।
500server_errorupload URL जनरेट करने में विफलजब सर्वर साइन किए गए upload URL को जनरेट करने में विफल रहता है तो लौटाया जाता है।