AI फ़ाइलें सहेजें: PiAPI आउटपुट URL से स्थायी संग्रहण तक

पूर्ण जनरेशन परिणाम देता है, लेकिन प्रदाता का URL स्थायी मीडिया लाइब्रेरी नहीं है। उपयोगकर्ता को बाद में परिणाम खोलना, बदलना या डाउनलोड करना हो तो फ़ाइल अपने नियंत्रण वाले संग्रहण में कॉपी करें और कॉपी की स्थिति जनरेशन से अलग रखें।

1. उपयोग किए मॉडल का आउटपुट पढ़ें

सहेजी ID से कार्य पढ़ें और फ़ाइल निकालने से पहले data.status का completed होना आवश्यक रखें। data.output की संरचना मॉडल और कार्य प्रकार से बदलती है। संबंधित उदाहरण देखें; हर उत्तर में समान शीर्ष-स्तरीय चित्र या वीडियो URL मानकर न चलें।

उदाहरण के लिए, Kling के दस्तावेज़ वाले उत्तर में वीडियो संसाधनों का works ऐरे है। अन्य मॉडल अलग फ़ील्ड उपयोग करते हैं। कार्य ID, मॉडल, प्रकार, पूर्णता समय और चुने संसाधन का इंडेक्स अपनी जॉब के साथ रखें, ताकि पुनः प्रयास वही परिणाम पा सके।

2. तुरंत कॉपी करें और सेवा की अवधि जाँचें

PiAPI के आउटपुट संग्रहण दस्तावेज़ सेवा और होस्टिंग स्थान के अनुसार अलग नियम बताते हैं। कुछ प्रविष्टियाँ छोटी अवधि बताती हैं, अन्य प्रदाता की CDN नीति पर निर्भर हैं। पेज में पुरानी सेवाएँ भी हैं। एक अवधि सभी वर्तमान मॉडलों पर लागू न करें और बिना बताई अवधि को असीमित न मानें।

पूर्णता के बाद Webhook या पोलिंग से बैकग्राउंड कॉपी शुरू करें। कॉलबैक की पुष्टि से पहले जॉब स्थायी रूप से सहेजें। नीचे का क्रम आपके ऐप की संग्रहण स्थितियाँ दिखाता है, PiAPI कार्य API की स्थितियाँ नहीं।

generation completed → copy queued → downloading → verified → saved
                                      ↘ copy failed → retry copy

3. सहेजा हुआ बताने से पहले बाइट जाँचें

परिणाम URL से डाउनलोड करते समय PiAPI API कुंजी आगे न भेजें। अनुमत गंतव्य सीमित करें, रीडायरेक्ट जाँचें और आकार व समय की सीमा रखें। HTTP स्थिति, वास्तविक बाइट संख्या, अपेक्षित मीडिया प्रकार और सामान्य पठनीयता जाँचें। 200 उत्तर वाला HTML त्रुटि पेज सहेजा गया वीडियो नहीं है।

अस्थायी ऑब्जेक्ट में लिखें, चेकसम निकालें और सफल सत्यापन के बाद ही अंतिम ऑब्जेक्ट प्रकाशित करें। कार्य ID व संसाधन इंडेक्स पर आधारित स्थिर कुंजी रखें। ऑब्जेक्ट कुंजी, बाइट, चेकसम और सहेजने का समय दर्ज करें; पहुँच नीति के अनुसार अपना नियंत्रित URL दें।

4. संग्रहण का पुनः प्रयास जनरेशन से अलग रखें

कॉपी विफल हो तो जनरेशन पूर्ण ही रहने दें और स्रोत उपलब्ध रहने तक कॉपी फिर करें। स्थायी विशिष्ट रिकॉर्ड दोहराई घटनाओं से डुप्लिकेट मीडिया बनने से रोकता है। URL पढ़ा न जाए तो कार्य दोबारा पढ़कर वर्तमान आउटपुट देखें; इससे समय-सीमा पार फ़ाइल की वापसी सुनिश्चित नहीं होती। रिलीज़ से पहले दोहराई घटनाएँ, अधूरे डाउनलोड और अनुपलब्ध URL जाँचें।

संदर्भ: आउटपुट संग्रहण, Kling कार्य पढ़ना और Webhook। यह ऐप संग्रहण का तरीका है, PiAPI की अभिलेखीय संरक्षण की गारंटी नहीं।