त्रुटि और समस्या निवारण

Linux, macOS और Windows सपोर्ट करता है, Node.js 18+ और आधुनिक ब्राउज़र चाहिए। सारी AI प्रोसेसिंग क्लाउड API से होती है, इसलिए आपका लोकल मशीन कितना भी आम हो, कोई रुकावट नहीं; हाई-एंड GPU तो पूरी तरह बेकार है।

सिर्फ़ एक Agnes AI API Key। Agnes AI की आधिकारिक वेबसाइट (agnes-ai.com) पर रजिस्टर करें और मुफ़्त में पाएँ, टेक्स्ट, इमेज, वीडियो जनरेशन और वॉइस सिंथेसिस सब इसी से। सारी क्षमताएँ Agnes AI के मुफ़्त मॉडल से, कोई अतिरिक्त कॉन्फ़िगरेशन नहीं।

हाँ। मैनुस्क्रिप्ट वीडियो मोड बैच प्रोसेसिंग के लिए ही बना है: एक लंबा लेख डालें, अपने आप कई हिस्सों में बँट जाएगा, हर हिस्से का वीडियो बनेगा, फिर सबमें एक जैसी आवाज़ और सबटाइटल जुड़ेंगे।

ब्रेकपॉइंट रिज़्यूम है। अगर जनरेशन टास्क बीच में टूट जाए (नेटवर्क कट, रीस्टार्ट आदि), रीस्टार्ट के बाद आखिरी सफल चेकपॉइंट से अपने आप आगे बढ़ेगा, प्रोग्रेस नहीं खोएगी। अधिकांश विफलताएँ अस्थायी कारणों से होती हैं — मॉडल सेवा में उतार-चढ़ाव, नेटवर्क टाइमआउट या दर सीमा। पहले विफलता पैनल में "कार्य पुनः प्रयास" पर क्लिक करें — कार्य विफल चरण से (चेकपॉइंट-आधारित) फिर शुरू होगा और अधिकांश स्थितियों में स्वयं ठीक हो जाएगा।

अधिकांश विफलताएँ अस्थायी कारणों से होती हैं — मॉडल सेवा में उतार-चढ़ाव, नेटवर्क टाइमआउट या दर सीमा। ऐप के विफलता पैनल में पहले "कार्य पुनः प्रयास" पर क्लिक करें — कार्य विफल चरण से फिर शुरू होगा और अधिकांश स्थितियों में दोबारा भेजे बिना स्वयं ठीक हो जाएगा। यदि कई प्रयासों (≥ 2) के बाद भी विफल रहे, तो फ़ीडबैक क्षेत्र स्वतः खुल जाएगा: एक क्लिक में निदान जानकारी कॉपी करें और पहले से भरे GitHub Issue पर जाएँ, बिना अपना वातावरण मैन्युअली बताए।

Agnes, Video 2.5 Flash जैसे वीडियो मॉडलों के लिए एक साझा मुफ़्त इन्फ़रेंस क्यू चलाता है, और पीक समय में यह 10 मिनट से अधिक तक भरी रह सकती है। जब क्यू भरी होती है, हर सबमिशन HTTP 503 · video_queue_full और मूल संदेश "video queue is full, please retry later (request id: …)" के साथ अस्वीकार हो जाता है। कोई टास्क नहीं बनता, कोई कोटा खर्च नहीं होता और कुछ भी नष्ट नहीं होता — यह Agnes की ओर की क्षमता का मुद्दा है, आपके प्रॉम्प्ट या सेटअप की समस्या नहीं। v7.0 से, क्यू भरी होने के कारण अस्वीकृति सामान्य रीट्राई बजट पर नहीं गिनी जाती: यह एक समर्पित रीट्राई ट्रैक पर चली जाती है (डिफ़ॉल्ट रूप से अधिकतम 15 प्रयास, AGNES_VIDEO_BUSY_RETRY_ATTEMPTS से समायोज्य), पहला प्रयास तुरंत शुरू होता है और बाद के प्रयास 30–60 सेकंड के अंतराल पर होते हैं। v7.1 से, विफलता पैनल और टास्क बनाने का संदेश उन ऑफ़-पीक समय-खिड़कियों का भी सुझाव देता है जब अपस्ट्रीम ऐतिहासिक रूप से अधिक सहज रहता है, जो आपके स्थानीय समय में दिखाई जाती हैं। Agnes 503 त्रुटियों से बचने के लिए: ऑफ़-पीक समय में रीट्राई करें, दूसरे वीडियो मॉडल पर स्विच करें (Video 2.0 अलग क्यू का उपयोग करता है और अक्सर टास्क स्वीकार कर लेता है), या अधिक API key जोड़ें — हर key का अपना कोटा होता है। अपस्ट्रीम प्रदाता की ओर से एक और सूचना: Agnes चीन साइट 2026-10-26 12:00 (बीजिंग समय) से रियल-नेम वेरिफिकेशन लागू करती है — बिना वेरिफिकेशन वाले खातों की API कॉल दर कम हो जाएगी — और अपस्ट्रीम को उम्मीद है कि उसके बाद 503 व "queue is full" जैसी व्यस्तता संबंधी त्रुटियाँ काफी कम होंगी।

401 Unauthorized या "अवैध टोकन" प्रतिक्रिया आमतौर पर यह दर्शाती है कि API कुंजी उस डोमेन से मेल नहीं खाती जिसे अनुरोध भेजा जा रहा है — उदाहरण के लिए, ग्लोबल साइट पर जारी कुंजी का उपयोग चीन के घरेलू एंडपॉइंट api.agnes-ai.cn पर किया जा रहा है (या इसके विपरीत)। अलग-अलग साइटों के लिए जारी कुंजियाँ गलत डोमेन पर भेजने पर अस्वीकार कर दी जाती हैं। v6.4.2 से, हर कुंजी को अपने एक्सेस डोमेन से बाइंड किया जा सकता है, और वन-क्लिक "डोमेन ऑटो-डिटेक्ट" बटन हर कुंजी को com / cn / cn_bak पर जाँचकर मेल खाता डोमेन स्वतः भर देता है। API कुंजी पैनल में अपनी कुंजी से मेल खाता डोमेन चुनें, या ऑटो-डिटेक्ट चलाएँ। ग्लोबल साइट की कुंजियों के लिए apihub.agnes-ai.com, या cn_bak फ़ॉलबैक डोमेन (apihub.agnes-ai.cn, जो घरेलू और ग्लोबल दोनों कुंजियाँ स्वीकार करता है) उपयोग करें।

फ़ीडबैक ऐप में और GitHub दोनों जगह उपलब्ध है। ऐप में कार्य विफल होने पर, विफलता पैनल "निदान जानकारी कॉपी करें" और "GitHub Issue खोलें" बटन देता है, जो ऐप संस्करण, कार्य प्रकार, विफल चरण, त्रुटि संदेश और पुनः प्रयास संख्या स्वतः जोड़ते हैं, जिससे अनुरक्षक समस्या जल्दी पहचान सकें। आप GitHub Issues पेज (github.com/lcy362/agnes-video-generator/issues) पर जाकर मौजूदा रिपोर्ट देख सकते हैं या नया Issue खोल सकते हैं।