दस्तावेज़ देखें
API संदर्भ
YouTube Download API
अपने क्लाउड स्टोरेज के लिए YouTube वीडियो या ऑडियो डाउनलोड करें। संकल्प, प्रारूप और क्लिप अवधि चुनें, फिर पूरा होने के माध्यम से अतुल्यकालिक नौकरी को ट्रैक करें।
YouTube वीडियो डाउनलोड API — Python उदाहरण
अनुरोध बनाएँ
11-character ID वीडियो URL से, पूर्ण URL नहीं।
एडवांस्ड मीडिया विकल्प
एक प्रारूप चयनकर्ता गुणवत्ता, फ्रेम दर और ऑडियो भाषा चयन ओवरराइड करता है। आउटपुट प्रारूप और क्लिप बाउंड अभी भी लागू होते हैं। क्लिप एंड को शुरू करना चाहिए; या तो बाध्य किया जा सकता है।
भंडारण गंतव्य
खाली यूटीसी अपलोड की तारीख (YYYYMMDD) का उपयोग करता है।
कोड चलाने से पहले अपने सर्वर पर अपना संग्रहण क्रेडेंशियल जोड़ें। उन्हें फ़ाइलों को अपलोड करने की अनुमति की आवश्यकता होती है।
प्रदाता क्रेडेंशियल और भंडारण आवश्यकताओंCompletion webhook
वेबहुक पेलोड, सत्यापन और रिट्राइज़Markdown पूरा परिणाम पर लागू होता है। प्राप्तियों और नौकरी की स्थिति उनके मूल क्षेत्रों को रखती है।
https://data.flashdata.dev/v1/queriesपैरामीटर
भेजें source और video_id शीर्ष स्तर पर। स्रोत विकल्प params. वैकल्पिक क्षेत्रों को छोड़ा जा सकता है।
अनुरोध का मुख्य भाग
sourcestring / ज़रूरी- youtube_download को सेट करें।
video_idstring / ज़रूरी- 11-character YouTube वीडियो ID, जैसे कि FUfGcZ092b0। अक्षरों, संख्याओं, अंडरस्कोर और हाइफेन्स को स्वीकार करता है।Exactly 11 वर्णडिफ़ॉल्ट:
सेट नहींस्वीकृत प्रारूप
^[A-Za-z0-9_-]{11}$ paramsobject / ज़रूरी- इस अनुरोध के लिए Settings
callback_urlstring · nullable / वैकल्पिक- केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।डिफ़ॉल्ट:
सेट नहीं
वीडियो और ऑडियो
params.download_typestring / वैकल्पिक- audio_video merges वीडियो और ऑडियो; वीडियो केवल वीडियो का चयन करता है; ऑडियो केवल ऑडियो का चयन करता है।1 to 11 वर्णमान:
audio_video / video / audioडिफ़ॉल्ट:"audio_video" params.video_qualitystring / वैकल्पिक- वीडियो रिज़ॉल्यूशन चयन। ऑडियो-केवल डाउनलोड के लिए ओमित।1 to 40 वर्णमान:
best / worst / <=144 / ==144 / >=144 / <=360 / ==360 / >=360 / <=480 / ==480 / >=480 / <=720 / ==720 / >=720 / <=1080 / ==1080 / >=1080 / <=1440 / ==1440 / >=1440 / <=2160 / ==2160 / >=2160 / <=4320 / ==4320 / >=4320डिफ़ॉल्ट:"<=720" params.fpsstring / वैकल्पिक- फ्रेम-रेट बाधा:> = =, <= या = == के बाद 1 से 240 तक एक मान होता है। ऑडियो-केवल डाउनलोड के लिए ओमित।1 to 6 वर्णडिफ़ॉल्ट:
सेट नहींस्वीकृत प्रारूप
^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$ params.audio_languagestring / वैकल्पिक- ऑडियो ट्रैक चयन। audio_video और ऑडियो पर लागू होता है।1 to 8 वर्णमान:
default / originalडिफ़ॉल्ट:"default" params.audio_qualitystring / वैकल्पिक- ऑडियो-केवल बिटरेट kbps में, या सबसे अच्छा है। संख्यात्मक विकल्प को स्ट्रिंग के रूप में भेजा जाना चाहिए। वीडियो डाउनलोड के लिए Omit।1 to 10 वर्णमान:
best / 320 / 256 / 192 / 128डिफ़ॉल्ट:"best" params.output_formatstring / वैकल्पिक- वीडियो: mp4, webm या mkv. ऑडियो: m4a, mp3 या opus।1 to 10 वर्णमान:
mp4 / webm / mkv / m4a / mp3 / opusडिफ़ॉल्ट:mp4 (video) / m4a (audio) params.yt_dlp_formatstring / वैकल्पिक- उन्नत प्रारूप चयनकर्ता, 1 से 1,024 वर्णों तक सफेद स्पेस को ट्रिम करने के बाद। नियंत्रण वर्णों को खारिज कर दिया जाता है। Overrides video_quality, fps और audio_language, जिसका मान तब नजरअंदाज कर रहे हैं; उत्पादन प्रारूप और क्लिपिंग अभी भी लागू होते हैं।1 to 1,024 वर्णडिफ़ॉल्ट:
सेट नहीं params.upload_metadataboolean / वैकल्पिक- अपने भंडारण में मीडिया फ़ाइल के साथ एक मेटाडाटा JSON फ़ाइल अपलोड करें।
trueयाfalseडिफ़ॉल्ट:false
क्लिपिंग
params.start_atstring / वैकल्पिक- एच: एमएम: एसएस या एचएच: एमएम: एसएस प्रारूप, 00:00:00 से 12:00:00 तक। जब केवल end_at की आपूर्ति की जाती है तो 00:00:00 को डिफ़ॉल्ट रूप से परिभाषित किया जाता है।1 to 8 वर्णडिफ़ॉल्ट:
सेट नहींस्वीकृत प्रारूप
^\d{1,2}:[0-5]\d:[0-5]\d$ params.end_atstring / वैकल्पिक- एच: एमएम: एसएस या एचएच: एमएम: एसएस प्रारूप में क्लिप अंत, 12:00:00 तक। बाद में start_at से होना चाहिए।1 to 8 वर्णडिफ़ॉल्ट:
सेट नहींस्वीकृत प्रारूप
^\d{1,2}:[0-5]\d:[0-5]\d$
भंडारण गंतव्य
params.storageobject / ज़रूरी- पूरा मीडिया फ़ाइलों के लिए गंतव्य। केवल सूचीबद्ध भंडारण क्षेत्रों को स्वीकार किया जाता है।
params.storage.storage_typestring / ज़रूरी- भंडारण प्रदाता: s3, s3_compatible, oss, gcs, azure, cos, bos या tos।
params.storage.storage_urlstring / ज़रूरी- गैर-खाली बाल्टी या कंटेनर नाम, 1,024 वर्ण तक। व्हाइटस्पेस को घेरना हटा दिया जाता है। S3 के लिए, एक वैध AWS बाल्टी नाम का उपयोग बिना URL या फ़ोल्डर पथ के करें; फ़ोल्डर object_prefix में हैं।
params.storage.object_prefixstring / वैकल्पिक- ऑब्जेक्ट-की उपसर्ग, 1 से 512 वर्ण। प्रत्येक slash-separated खंड ASCII अक्षरों, अंक, डॉट्स, अंडरस्कोर और हाइफेन्स को स्वीकार करता है; खाली खंडों, और .. को खारिज कर दिया जाता है। कोई प्रमुख स्लैश नहीं। व्हाइटस्पेस और एक ट्रेलिंग स्लैश को घेरना हटा दिया जाता है। YYYMMDD, archive/YYYYMMDD. सहित UTC अपलोड की तारीख का उपयोग करता हैडिफ़ॉल्ट:
"YYYYMMDD" params.storage.access_keystring / वैकल्पिक- S3, S3-compatible, OSS, COS, BOS या TOS के लिए एक्सेस कुंजी; secret_key के साथ मिलकर।
params.storage.secret_keystring / वैकल्पिक- S3, S3-compatible, OSS, COS, BOS या TOS के लिए गुप्त कुंजी।
params.storage.endpoint_urlstring / वैकल्पिक- S3-संगत भंडारण या OSS के लिए सार्वजनिक HTTPS समापन बिंदु। COS, BOS और TOS इसे क्षेत्र से अलग कर देता है।
params.storage.regionstring / वैकल्पिक- COS, BOS और TOS के लिए आवश्यक; S3 और S3-compatible डाउनलोड के लिए भी आपूर्ति करता है। COS बाल्टी नामों में APPID शामिल है।
params.storage.service_accountobject / वैकल्पिक- GCS सेवा खाता: project_id, client_email और PEM private_key.
params.storage.account_namestring / वैकल्पिक- Azure संग्रहण खाता नाम। storage_url में कंटेनर नाम का उपयोग करें।
params.storage.sas_tokenstring / वैकल्पिक- जल्दी और हस्ताक्षर के साथ राइट-सक्षम Azure कंटेनर SAS।
जवाब
अनुरोध बिल्डर Async या Batch के साथ डाउनलोड करने की अनुमति देता है और इसके लिए आवश्यकता होती है params.storage. HTTP 200 साथ status: pending स्वीकृति की पुष्टि करता है, वितरण नहीं करता है। Batch प्रति वीडियो एक नौकरी रसीद देता है ID।
सबमिशन usage.credits है 0. डाउनलोड सफल वितरण के बाद वितरित मीडिया वॉल्यूम द्वारा बिल किए गए हैं; वैकल्पिक मेटाडाटा फ़ाइलों को डाउनलोड करने के लिए शुल्क नहीं मिला है।
पोल job.status जब तक completed, फिर परिणाम JSON को पुनः प्राप्त करें। पर मीडिया विवरण पढ़ें results[0], अपलोड की गई वस्तु सहित file_url, फ़ाइल का आकार और चेकसम।
परिणाम पढ़ें
नौकरी पूरा करने के बाद, अपने परिणाम लिंक से JSON को response.json के रूप में सहेज लें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह मीडिया को डाउनलोड किए बिना फ़ाइल विवरण पढ़ता है या किसी अन्य अनुरोध को करता है।
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {name: result.get(name) for name in (
"file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))स्थिति में मीडिया विवरण शामिल हो सकते हैं job.result. डिफ़ॉल्ट JSON वर्कफ़्लोज़ उपलब्ध होने पर उनका उपयोग करते हैं और अन्यथा उनका पालन करते हैं। rel: results लिंक; ऐसा नहीं माना जाता है कि एक इनलाइन परिणाम हमेशा मौजूद होता है।
सभी प्रस्तुतीकरण प्रतिक्रिया फ़ील्ड
| फील्ड | विवरण |
|---|---|
idstring | नौकरी ID. |
sourcestring | youtube_download. |
statusstring | जब नौकरी स्वीकार की जाती है तो लंबित। |
created_atstring | ISO 8601 प्रारूप में नौकरी निर्माण समय। |
usage.creditsnumber | जमा करने पर 0 डाउनलोड पूरा होने के बाद डेटा की मात्रा को वितरित करके चार्ज किया जाता है। |
linksarray | नौकरी की स्थिति और परिणाम पूरा उत्पादन के लिए लिंक के लिए स्वयं लिंक का पालन करें। |
links[].relstring | स्वयं या परिणाम। |
links[].hrefstring | एक ही API कुंजी के साथ क्वेरी करने के लिए URL। |
links[].methodstring | GET. |
पूरा मीडिया फ़ाइल फ़ील्ड
| फील्ड | विवरण |
|---|---|
results[0].file_urlstring | अपने भंडारण में मीडिया फ़ाइल का स्थान। |
results[0].file_sizeinteger | बाइट्स में मीडिया फाइल का आकार। |
results[0].downloaded_bytesinteger | बिलिंग के लिए उपयोग किए जाने वाले मीडिया बाइट्स को वितरित किया गया। |
results[0].md5string | मीडिया फ़ाइल का MD5 checksum। |
results[0].resolutionstring · nullable | ऑडियो-केवल आउटपुट या अनुपलब्ध ऊंचाई के लिए वीडियो रिज़ॉल्यूशन, या null। |
results[0].durationnumber · nullable | उपलब्ध होने पर सेकंड में अवधि |
results[0].output_formatstring | आउटपुट फ़ाइल प्रारूप। |
results[0].fpsnumber · nullable | उपलब्ध होने पर फ्रेम रेट। |
results[0].video_codecstring · nullable | उपलब्ध होने पर वीडियो कोडेक। |
results[0].audio_codecstring · nullable | उपलब्ध होने पर ऑडियो कोडेक। |
results[0].dynamic_rangestring · nullable | उपलब्ध होने पर वीडियो गतिशील रेंज। |
results[0].metadataobject · optional | Metadata file_url, file_size और md5 जब upload_metadata true है। मेटाडेटा बाइट को डाउनलोड शुल्क से बाहर रखा गया है। |
ऊपर दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं। प्रारूप विकल्प डिलीवरी रिकॉर्ड पर लागू होते हैं, न कि मीडिया फ़ाइल। JSON, सादे पाठ और Markdown प्रारूप.
Async & बैच जीवनचक्र
सबमिशन एक रसीद लौटाता है, परिणाम नहीं देता है। Async एक नौकरी बनाता है; बैच में एक अलग काम देता है queries[] प्रत्येक स्वीकृत क्वेरी के लिए। प्रत्येक नौकरी को स्वतंत्र रूप से ट्रैक और पुनर्प्राप्त करें।
प्रस्तुत करना data.flashdata.dev; नौकरी की स्थिति और परिणाम पढ़ने से api.flashdata.dev उसी X-API-Key के साथ। लिंक्ड API मूलभूत उदाहरण Python और cURL का उपयोग करते हैं।
1. नौकरी बचाओ IDs
Async के साथ एक डाउनलोड सबमिट करें, या एक Batch क्वेरीज़ सरणी के अंदर एकाधिक डाउनलोड अनुरोधों को डाल दें। प्रत्येक प्रविष्टि की जरूरत है params.storage. प्रत्येक वापसी कार्य ID बचाओ।
2. स्थिति की जाँच करें
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: देरी और सम्मान के साथ मतदानRetry-Afterजब उपस्थित हो।completed: परिणाम प्राप्त करें।failed: निरीक्षणjob.error.job.status पढ़ें, प्रस्तुतीकरण रसीद की स्थिति नहीं।
नौकरी की स्थिति API संदर्भ3. Fetch परिणाम
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsपूरा होने के बाद, परिणाम को प्रमाणित करें, फिर अपने API कुंजी के बिना 302 संग्रहण URL प्राप्त करें। JSON को 24 घंटे पूरा होने के भीतर सहेजें।
JSON अपने भंडारण के लिए वितरित मीडिया का वर्णन करता है। मीडिया फ़ाइल एक्सेस करें.
Fetch परिणाम · Python और cURL · जवाब के फ़ॉर्मैट
परिणाम डाउनलोड API
मतदान और मौजूदा परिणाम प्राप्त करने के लिए क्वेरी क्रेडिट का उपभोग नहीं करते हैं। एक मतदान टाइमआउट नौकरी को रद्द नहीं करता है: डुप्लिकेट बिलेबल वर्क जमा करने के बजाय अपने ID को रखें। त्रुटि कोड और पुनर्प्राप्ति व्यवहार.
पूरा होने पर वेबहुक
क्वेरी के अनुसार सदस्यता लें
सेट callback_url एक async अनुरोध के शीर्ष स्तर पर, या प्रत्येक क्वेरी के अंदर एक बैच में, बाहर params. कोई अलग वेबहुक पंजीकरण अनुरोध की आवश्यकता नहीं है।
पोर्ट 443 पर एक सार्वजनिक HTTPS URL का उपयोग करें। FlashData POSTs प्रत्येक नौकरी के लिए एक अधिसूचना तक पहुँचने के लिए completed या failed; इस घटना में लिंक शामिल हैं, न कि परिणाम स्वयं।
स्वीकार करना और सत्यापित करना
वापसी 2xx इस घटना को स्वीकार करने के बाद। Deduplicate by Deduplicate delivery_id, भी भेजा गया X-Delivery-Id. पुनर्निर्देशन का पालन नहीं किया जाता।
विफल प्रसव एक्सोनेंशियल बैकऑफ़ के साथ वापसी, अप करने के लिए 8 कुल प्रयास करता है और अधिक पूरा होने के बाद 24 घंटे. मतदान को गिरने के रूप में रखें।
कॉलबैक को इस्तीफा नहीं दिया जाता है। नौकरी की पुष्टि करें ID, स्रोत और टर्मिनल स्थिति के माध्यम से प्रमाणित स्थिति समापन बिंदु अधिसूचना को संसाधित करने से पहले। वितरण ID, deduplication के लिए है, प्रामाणिकता का प्रमाण नहीं है।
उदाहरण वेबहुक घटना और फ़ील्ड
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_download",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| फील्ड | विवरण |
|---|---|
delivery_idstring | स्थिर वितरण पहचानकर्ता। इस मूल्य का उपयोग करके Deduplicate नोटिफिकेशन; इसे X-Delivery-Id हेडर में भी भेजा जाता है। |
idstring | नौकरी ID |
sourcestring | अनुरोधित डेटा स्रोत। |
statusstring | पूरा या विफल हो गया। |
linksarray | स्थिति और परिणाम लिंक। अधिसूचनाओं में परिणाम सामग्री या एक API कुंजी शामिल नहीं है। |
links[].relstring | स्वयं या परिणाम। |
links[].hrefstring | पूर्ण प्रबंधन API URL; अपने API कुंजी के साथ प्रमाणित। |
links[].methodstring | GET. |
Bulk फ़ाइल प्रसंस्करण
प्रत्येक पंक्ति में एक वीडियो ID अपलोड करें और स्रोत के साथ Bulk जॉब बनाएं: youtube_download. साझा विकल्प फ़ाइल में प्रत्येक ID पर लागू होते हैं।
में आवश्यक भंडारण गंतव्य रखो options.storage और मीडिया सेटिंग्स में options. एकल नौकरी और Batch डाउनलोड इसके बजाय params.storage का उपयोग करते हैं।
मीडिया फ़ाइलों को आपके क्लाउड स्टोरेज में वितरित किया जाता है। पूरा Bulk परिणाम में एक प्रकटन और परिणाम के हिस्से शामिल हैं जो डाउनलोड का वर्णन करते हैं। पूरे Bulk नौकरी पूरा होने के बाद 24 घंटों के भीतर प्रकट होने और भागों को बचाओ।
Bulk प्रसंस्करण API · Python और cURL · Batch JSON अनुरोध
इस स्रोत के लिए Bulk वर्कफ़्लो बनाएं · रोकें, फिर से शुरू करें और पुनर्प्राप्त करें
भंडारण गंतव्य
शामिल params.storage प्रत्येक डाउनलोड अनुरोध में। सेट storage_url अपनी बाल्टी या कंटेनर नाम पर और लिखने के साथ क्रेडेंशियल की आपूर्ति। अपने सर्वर पर भंडारण क्रेडेंशियल रखें।
{
"storage_type": "s3_compatible",
"storage_url": "your-media-bucket",
"object_prefix": "archive/YYYYMMDD",
"endpoint_url": "https://your-s3-endpoint.example.com",
"region": "your-provider-region",
"access_key": "<storage-access-key>",
"secret_key": "<storage-secret-key>"
}object_prefix डिफ़ॉल्ट करने के लिए YYYYMMDD, यूटीसी अपलोड की तारीख के साथ बदल दिया। एक निश्चित निर्देशिका या एक टेम्पलेट का उपयोग करें जैसे कि archive/YYYYMMDD.
s3- access_key और secret_key की आपूर्ति के साथ लिखने का उपयोग करें। अपने बाल्टी के एडब्ल्यूएस क्षेत्र में क्षेत्र सेट करें।
s3 उदाहरण
{ "storage_type": "s3", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "us-east-1" } s3_compatible- आपूर्ति access_key, secret_key और एक सार्वजनिक HTTPS endpoint_url अपने प्रदाता द्वारा आवश्यक फ़ील्ड सेट करें; Cloudflare R2 ऑटो का उपयोग करता है।
s3_compatible उदाहरण
{ "storage_type": "s3_compatible", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com", "region": "auto" } azure- आपूर्ति account_name और sas_token, लिखने की अनुमति के साथ एक कंटेनर SAS (sp में w), संसाधन sr=c, समाप्ति se, संस्करण sv और हस्ताक्षर sig शामिल हैं। storage_url कंटेनर नाम है। endpoint_url, access_key या secret_key को नहीं भेजते हैं।
azure उदाहरण
{ "storage_type": "azure", "storage_url": "your-media-container", "account_name": "yourstorageaccount", "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE" } bos- आपूर्ति access_key, secret_key और क्षेत्र: Bj, Su या hkg। जब छोड़ दिया जाता है तो अंत बिंदु क्षेत्र से प्राप्त होता है। बिना डॉट्स के एक बाल्टी नाम का प्रयोग करें।
bos उदाहरण
{ "storage_type": "bos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "bj" } cos- आपूर्ति access_key, secret_key और एक अप-* क्षेत्र, जैसे कि अप-होंगकोंग। storage_url में APPID suffix शामिल होना चाहिए। endpoint_url को न भेजें; यह क्षेत्र से प्राप्त होता है।
cos उदाहरण
{ "storage_type": "cos", "storage_url": "your-media-bucket-1234567890", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "ap-hongkong" } gcs- service_account को project_id, client_email (a .gserviceaccount.com) और PEM private_key के साथ अपने सर्विस अकाउंट से सप्लाई करें। खाते को बाल्टी तक पहुंच लिखना चाहिए। access_key, secret_key, क्षेत्र या endpoint_url भेजने के लिए नहीं है।
gcs उदाहरण
{ "storage_type": "gcs", "storage_url": "your-media-bucket", "service_account": { "project_id": "your-project-id", "client_email": "[email protected]", "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n" } } oss- आपूर्ति access_key, secret_key और बाल्टी क्षेत्र के सार्वजनिक HTTPS endpoint_url.
oss उदाहरण
{ "storage_type": "oss", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com" } tos- आपूर्ति access_key, secret_key और एक cn-, ap-, eu- या us- prefix के साथ क्षेत्र। जब छोड़ दिया जाता है तो अंत बिंदु क्षेत्र से प्राप्त होता है। बिना डॉट्स के एक बाल्टी नाम का प्रयोग करें।
tos उदाहरण
{ "storage_type": "tos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "cn-beijing" }
परिणाम file_url अपने भंडारण में एक वस्तु की पहचान करता है। निजी वस्तुओं को आपके भंडारण प्रदाता के प्राधिकरण या एक हस्ताक्षरित URL की आवश्यकता होती है; FlashData API कुंजी आपकी बाल्टी तक पहुंच प्रदान नहीं करती है।
एक पूर्ण प्रस्तुतीकरण, मतदान और डाउनलोड वर्कफ़्लो के लिए, देखें YouTube ऑडियो को Amazon S3 के लिए डाउनलोड करें.
फ़ाइल वितरण
नौकरी rel: results एक पुनर्निर्देशित करने के लिए अंतिम बिंदु डिफ़ॉल्ट परिणाम JSON, नहीं, MP4 download FlashData आपके द्वारा आपूर्ति की गई बाल्टी या कंटेनर में वास्तविक मीडिया को अपलोड करता है। मीडिया रिटेंशन आपकी बाल्टी की नीति का पालन करता है; नौकरी का परिणाम JSON पूरा होने के बाद 24 घंटे समाप्त हो जाता है।
results[0].file_url ऑब्जेक्ट की पहचान करता है लेकिन स्वचालित रूप से एक सार्वजनिक या हस्ताक्षरित URL नहीं है। अपने भंडारण SDK के साथ निजी मीडिया तक पहुंचें, या अपने सर्वर पर एक अल्पकालिक हस्ताक्षरित URL उत्पन्न करें। अपने भंडारण प्रदाता को FlashData API कुंजी नहीं भेज सकते हैं।
सक्षम upload_metadata अपलोड करने के लिए {video_id}_meta.json उसी उपसर्ग में साथी। इसके स्थान और चेकसूम नीचे दिखाई देते हैं results[0].metadata.
कंसोल का ब्राउज़र डाउनलोड मोड अलग है। सार्वजनिक API डाउनलोड अपने खुद के भंडारण का उपयोग करते हैं; केवल सांत्वना-केवल शामिल नहीं है browser_delivery सेटिंग्स।
त्रुटि
अपलोड विफलताओं या भंडारण के लिए 403, प्रदाता, बाल्टी, क्षेत्र, समापन बिंदु और ऑब्जेक्ट-राइट अनुमतियों की जांच करें। अप्राप्य या निजी file_url अपने आप में अपलोड असफल होने का मतलब नहीं है: अपने स्टोरेज प्रदाता के माध्यम से ऑब्जेक्ट को चेक करें।
एक हटाए गए या अनुपलब्ध वीडियो को मतदान द्वारा ठीक नहीं किया जा सकता है। अनुपलब्ध प्रारूपों के लिए, निरीक्षण मेटाडाटा प्रारूप, गुणवत्ता बाधाओं को आराम या उन्नत चयनकर्ता को हटा दें। केवल ऑडियो अनुरोधों की आवश्यकता होती है m4a, mp3 या opus; वीडियो अनुरोधों की आवश्यकता होती है mp4, webm या mkv.
यदि परिणाम JSON समाप्त हो गया है, तो पहले वितरित मीडिया के लिए अपनी बाल्टी की जांच करें। Resubmitting एक नया डाउनलोड बनाता है और एक अन्य चार्ज किया जा सकता है; यह पुराने परिणाम JSON ठीक नहीं है।
प्रमाणीकरण, संतुलन, अनुरोध प्रारूप और दर सीमा विफलताओं के लिए, साझा त्रुटि संदर्भ का उपयोग करें। अभी भी एक नौकरी का निर्माण हो सकता है; पुनः प्रयास करने से पहले मौजूदा काम की जांच करें।
चरण-दर-चरण गाइड: एक वीडियो डाउनलोड करें और डिलीवरी को सत्यापित करें
कीमतें
| योजना | उपयोग की दरेंप्रति जीबी वितरित | सदस्यता | प्रति बिलिंग अवधि में क्रेडिट शामिल |
|---|---|---|---|
| इस्तेमाल के अनुसार भुगतान | $0.10 | कोई मासिक शुल्क नहीं | ज़रूरत पर रिचार्ज करें |
| Micro | $0.08 | $49.00 / महीना | 1,000 क्रेडिट्स ($50.00 of API उपयोग) में शामिल |
| Starter | $0.07 | $199.00 / महीना | 4,000 क्रेडिट्स ($200.00 of API उपयोग) में शामिल |
| Pro | $0.06 | $499.00 / महीना | 10,000 क्रेडिट्स ($500.00 of API उपयोग) में शामिल |
| Scale | $0.05 | $999.00 / महीना | 20,000 क्रेडिट्स ($1,000.00 of API उपयोग) में शामिल |
| Business | $0.04 | $1,999.00 / महीना | 40,000 क्रेडिट्स ($2,000.00 of API उपयोग) में शामिल |
एक खाता प्लान। तीनों उत्पादों में साझा क्रेडिट। शामिल क्रेडिट से चुकाए गए उपयोग पर दोबारा शुल्क नहीं लगता।
वर्तमान मूल्य और योजना सीमा