समीक्षा 2026-11-10 · API संस्करण 2026-11-09 · Markdown पढ़ें
मीडिया अपलोड करना और सुरक्षित रखना
मीडिया बाइट सीधे अस्थायी प्राइवेट ऑब्जेक्ट स्टोरेज में जाते हैं। REST और MCP
अपलोड निर्देश लौटाते हैं; वे टूल JSON में बाइनरी फ़ाइल कंटेंट स्वीकार नहीं करते।
डिप्लॉयमेंट पर स्टोरेज कॉन्फ़िगर होना चाहिए अन्यथा अपलोड बनाना
provider_unavailable लौटाता है।
अपलोड लाइफ़साइकिल
- फ़ाइलनाम, घोषित MIME और बाइट संख्या के साथ
POST /api/v1/media/upload-intentsकॉल करें। रिटर्न किएassetIdऔरsessionIdको अलग पहचानों के रूप में सुरक्षित रखें। methodदेखें।presigned_putके लिए, रिटर्न किए हेडर का उपयोग करके पूरी फ़ाइलuploadUrlपर अपलोड करें।multipart_initiatedके लिए,partSizeBytesसे विभाजित करें, हर क्रमांकित पार्ट को उसके रिटर्न किए URL पर अपलोड करें और उसका ETag रसीद सुरक्षित रखें। स्टोरेज रिक्वेस्ट में AiVideoEditor बियरर की कभी न जोड़ें।sessionIdऔर, multipart के लिए, हरpartNumberऔरetagवालेmultipart.partsके साथPOST /api/v1/media/{assetId}/finalizeपर फ़ाइनलाइज़ करें।- ड्राफ़्ट के
mediaIdsमें फ़ाइनलाइज़ की गई ऐसेट ID का उपयोग करें। अकेला अपलोड इंटेंट ऐसेट को प्रकाशन योग्य नहीं बनाता।
सर्वर अपरिवर्तनीय अंतिम कॉपी पर वास्तविक बाइट और फ़ॉर्मैट देखता है। घोषित size/MIME रिज़र्वेशन इनपुट हैं, फ़ाइल वैधता का प्रमाण नहीं। समर्थित बेसलाइन फ़ैमिली JPEG, PNG और MP4 हैं; अलग गंतव्य सख्त सीमाएँ लगा सकते हैं। वर्तमान अधिकतम फ़ाइल आकार 500 MiB (524,288,000 बाइट) है। 50 MiB या उससे बड़ी फ़ाइलें multipart का उपयोग करती हैं, सामान्यतः 16 MiB पार्ट के साथ। इन डिफ़ॉल्ट से प्राप्त करने की बजाय हमेशा रिटर्न किए आकार, URL और एक्सपायरी का पालन करें।
{
"sessionId": "<session UUID from upload-intents>",
"multipart": {
"parts": [
{ "partNumber": 1, "etag": "<ETag returned by storage>" }
]
}
}
यह multipart आकार का चित्रण है; हर वास्तविक पार्ट शामिल करें। Single-PUT
फ़ाइनलाइज़ेशन केवल sessionId भेजता है। हर नए API म्यूटेशन को अपना
Idempotency-Key दें; सुरक्षित पहचान योग्य पुनः प्रयासों के लिए उसे सुरक्षित रखें।
रिज़्यूम या त्याग
एक्सपायर हुए साइन किए URL स्थायी मीडिया पते नहीं हैं। fromPart और toPart
(अधिकतम 64 पार्ट की समावेशी रेंज) के साथ POST /media/{id}/upload-parts से
ताज़ा multipart पार्ट URL माँगें। बाउंडेड रिक्वेस्ट आकार के लिए
API संदर्भ देखें। पूरे हुए पार्ट अनावश्यक रूप से दोबारा अपलोड न करें
और multipart असेंबली सीधे स्टोरेज से पूरी न करें: फ़ाइनलाइज़ेशन सर्वर-नियंत्रित है।
अधूरे अपलोड रद्द करते समय POST /media/{id}/abandon का उपयोग करें। यह
साझा क्लीनअप वर्कफ़्लो से उसका रिज़र्वेशन जारी करता है। सेशन एक्सपायरी या खपत
multipart स्थिति को नया इंटेंट चाहिए; स्टोरेज ऑब्जेक्ट कीज़ अनुमान न लगाएँ।
अस्थायी प्रतिधारण
GET /media/{id} स्थिति और डायनैमिक deleteAfter जानकारी लौटाता है,
स्थायी सार्वजनिक URL नहीं। शेड्यूल और इन-फ़्लाइट उपयोग काम के दौरान मीडिया की रक्षा करते हैं।
डिफ़ॉल्ट नीति अप्रयुक्त ड्राफ़्ट मीडिया 14 दिन, सेटल हुआ मीडिया 72 घंटे,
और विफल या अस्पष्ट काम संबंधित प्रयास के 7 दिन बाद तक रखती है।
वास्तविक प्रतिधारण सभी शेष रेफ़रेंस पर निर्भर है; deleteAfter null हो सकता है।
मूल फ़ाइलें रखें। यदि मीडिया एक्सपायर या डिलीटिंग है, तो प्रकाशन से पहले उसे दोबारा अपलोड करें।