सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

गाइड

YouTube Download सर्वोत्तम प्रथाओं

सही मीडिया आउटपुट चुनें, जो आप डाउनलोड करते हैं उसे नियंत्रित करें, और एक पूर्ण कार्य को एक उपयोगी निजी फ़ाइल में बदल दें।

इस पेज पर

अपने कार्य की जरूरत के बारे में क्या शुरू करें

आपका लक्ष्यउपयोग
बोली जाने वाली सामग्री को संक्षेप में प्रस्तुत करें या एक टेक्स्ट इंडेक्स बनाएंपहले एक मौजूदा ट्रांसक्रिप्ट पढ़ें। केवल तभी ऑडियो डाउनलोड करें जब आपके वर्कफ़्लो को ऑडियो की जरूरत हो, जैसे कि एक अलग भाषण-टू-टेक्स्ट स्टेप।
प्रक्रिया भाषण या ऑडियोकेवल ऑडियो आउटपुट। वीडियो ट्रैक करने से बचने के लिए अपने आवेदन का उपयोग नहीं किया जाता है।
एक लघु अंश दिखाएंसेट start_at और end_at। जांचें कि दोनों स्रोत वीडियो की अवधि के भीतर हैं।
प्ले या प्रक्रिया वीडियोMP4 ऑडियो और एक संकल्प टोपी के साथ अपने आवेदन के लिए अनुकूल; उदाहरण <=720 का उपयोग करता है।

आप चाहते हैं कि आउटपुट सहेजें

एक टैब चुनें और अपने पूरे अनुरोध को download-request.json के रूप में सहेजें। अपने स्रोत के लिए video_id बदलें। नीचे दिए गए सबमिशन कमांड इस फाइल को पढ़ते हैं, इसलिए ऑडियो चुनने या एक क्लिप वास्तविक अनुरोध को बदल देती है।

ऑडियो के साथ एक पूर्ण वीडियो, 720p पर छायांकित।

download-request.json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}

मालिक पहुँच और बाइट आधारित मूल्य निर्धारण की जाँच करें

Bash और jq का उपयोग करें, साथ ही CLI प्रोफाइल या FLASHDATA_API_KEY के लिए HTTP प्रोफाइल को बचाया गया। कुंजी youtube_download अनुमति की जरूरत है। डाउनलोड करने के लिए मालिक की पहुंच की आवश्यकता है; अस्थायी परीक्षण का उपयोग इसमें शामिल नहीं है। CLI उदाहरण आपके डिफ़ॉल्ट प्रोफ़ाइल का उपयोग करते हैं; यदि आपका नाम है तो प्रत्येक कमांड में --profile नाम जोड़ें।

निर्णयइसे इस तरह से लागू करें
अनुमानित लागतअपने अनुमानित आउटपुट बाइट्स के साथ लौटाए गए creditsPerTb और bytesPerUnit का उपयोग करें। मूल्य निर्धारण प्रति अनुरोध एक निश्चित शुल्क नहीं है।
नियंत्रण क्षेत्रप्रस्तुत करने से पहले ऑडियो, एक क्लिप या एक रिज़ॉल्यूशन कैप चुनें। अपने आवेदन में नौकरी-काउंट और खर्च नियमों को लागू करें।
वास्तविक शुल्क रिकॉर्ड करेंपूरा वितरण से उपयोग पढ़ें। प्रवेश से पहले क्रेडिट जमा हो सकता है; वर्तमान शेष प्रति नौकरी खर्च करने वाली कैप नहीं है।
नि: शुल्क चेक · CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

प्रत्येक आउटपुट के लिए एक निजी गंतव्य का उपयोग करें

अपने वास्तविक गंतव्य मूल्यों के साथ निजी तौर पर storage.json को सेव करें। इसे सोर्स कंट्रोल के बाहर रखें। प्रत्येक video/output संस्करण के लिए एक विशिष्ट object_prefix का उपयोग करें; विभिन्न आउटपुट के लिए एक उपसर्ग का उपयोग करने से एप्लिकेशन रिकॉर्ड्स को दोबारा मिलान करने के लिए कठिन बना देता है।

क्रेज़ीउद्देश्य
FlashData कुंजीडाउनलोड करें और अपनी नौकरी और डिलीवरी JSON पढ़ने के लिए जमा करें।
भंडारण अपलोड क्रेडेंशियलमीडिया को इच्छित बाल्टी और उपसर्ग के लिए लिखें।
आवेदन भंडारण पहचानएक अधिकृत उपयोगकर्ता को निजी ऑब्जेक्ट या समस्या एक्सेस पढ़ें।
storage.json · S3
{
  "storage_type": "s3",
  "storage_url": "YOUR_BUCKET",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1",
  "object_prefix": "media/video-001/mp4-720p-v1"
}
Linux / macOS · निजी फ़ाइल
chmod 600 storage.json

एक बार सहेजे गए अनुरोध को जमा करें

दोनों फाइलों को बचाने के बाद एक टैब चलाएं। कमांड storage.json को stdin के माध्यम से इंजेक्ट करता है और download-submission.json को बचाता है। इस रसीद को रखें। CLI के साथ, उसी रन ID को रिट्री के लिए बनाए रखें; केवल एक जानबूझकर नए आउटपुट के लिए एक नया ID का उपयोग करें। HTTP प्रस्तुतियाँ CLI के स्थानीय रन जर्नल का उपयोग नहीं करती हैं।

चयनित आउटपुट जमा करें
(
set -eu
umask 077
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async \
  --run-id download-001 --output download-submission.json
)

पहले CLI के साथ मान्य

ok: true और data.dryRun: true का चयन करें। यह एक नौकरी जमा किए बिना इनपुट और FlashData एक्सेस की जांच करता है; यह साबित नहीं होता कि अपलोड क्रेडेंशियल आपकी बाल्टी को लिख सकते हैं।

फ्री ड्राई रन
(
set -eu
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async --dry-run --json
)

मौजूदा नौकरी के लिए प्रतीक्षा करें

जमा रसीद मीडिया फ़ाइल नहीं है। CLI प्रतीक्षा करता है; HTTP कमांड एक बार स्टेटस पढ़ता है। जब तक पूरा हो गया या विफल हो गया तब तक अपनी समय सीमा के भीतर पढ़ा दोहराएं। एक स्थानीय टाइमआउट सर्वर नौकरी को रद्द नहीं करता है।

बचाया नौकरी के लिए प्रतीक्षा करें
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

डिलीवरी रिकॉर्ड पढ़ें, फिर मीडिया तक पहुंचें

पूरा होने के बाद, आपको जमा करने के लिए उपयोग किए जाने वाले उसी रास्ते का उपयोग करके delivery.json को पुनः प्राप्त करें। हस्ताक्षरित परिणाम URL JSON को पुनः प्राप्त करता है; परिणाम [0].file_url अपने भंडारण में मीडिया की पहचान करता है। एक निजी file_url को आपके अनुप्रयोग द्वारा जारी किए गए अपनी स्टोरेज रीड पहचान या लिंक की आवश्यकता होती है।

बचाओ delivery.json
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs result "$JOB_ID" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)

क्या दिया गया?

एक फ़ाइल स्थान, एक सकारात्मक file_size, एक MD5 और उपयोग की उम्मीद है। वितरित ऑब्जेक्ट के लिए रिकॉर्ड file_size; downloaded_bytes एक स्थानांतरण क्षेत्र है, जो उपयोग में अंतिम शुल्क के लिए प्रतिस्थापन नहीं है।

निरीक्षण delivery.json
(
set -eu
jq -e '.source == "youtube_download" and .status == "done"
  and (.results | length == 1) and (.results[0].file_size > 0)
  and (.results[0].md5 | test("^[a-fA-F0-9]{32}$"))' delivery.json >/dev/null
jq '{file: (.results[0] | {file_url, file_size, md5, duration, output_format}), usage}' delivery.json
)

S3 से स्थानीय प्रतिलिपि सत्यापित करें

OBJECT_KEY को file_url से वितरित मीडिया कुंजी में सेट करें, जिसमें इसके उपसर्ग शामिल हैं। AWS CLI का उपयोग पढ़ने के लिए, jq और OpenSSL के साथ करें। यह आपके चुने गए अनुरोध के अनुसार media.mp4 या media.mp3 को बचाता है और मौजूदा स्थानीय फ़ाइल को ओवरराइट किए बिना इसका आकार और चेकसूम की जांच करता है।

S3 read · कोई नया FlashData क्वेरी नहीं
(
set -eu
# Requires AWS CLI configured for read access, jq and OpenSSL.
# Set OBJECT_KEY to the delivered media object's key from file_url.
: "${OBJECT_KEY:?Set the delivered S3 object key}"
BUCKET=$(jq -er '.storage_url' storage.json)
REGION=$(jq -er '.region' storage.json)
FORMAT=$(jq -er '.params.output_format' download-request.json)
case "$FORMAT" in mp4|mp3) ;; *) echo 'Choose a filename for this format.' >&2; exit 1 ;; esac
LOCAL_FILE="media.$FORMAT"
test ! -e "$LOCAL_FILE" || { echo 'Keep the existing local file.' >&2; exit 1; }
EXPECTED_BYTES=$(jq -er '.results[0].file_size' delivery.json)
EXPECTED_MD5=$(jq -er '.results[0].md5 | ascii_downcase' delivery.json)
aws s3 cp "s3://$BUCKET/$OBJECT_KEY" "$LOCAL_FILE" --region "$REGION" --only-show-errors
ACTUAL_BYTES=$(wc -c < "$LOCAL_FILE" | tr -d '[:space:]')
ACTUAL_MD5=$(openssl dgst -md5 "$LOCAL_FILE" | awk '{print $NF}')
test "$ACTUAL_BYTES" = "$EXPECTED_BYTES"
test "$ACTUAL_MD5" = "$EXPECTED_MD5"
echo 'Delivery verified'
)

मंच है कि असफल से पुनर्प्राप्त

क्या हुआअगली कार्रवाई
प्रस्तुत करने का समय कोई पुष्टि की नौकरी के साथ IDबचाया CLI रन या अनुरोध इतिहास का निरीक्षण करें। मूल इनपुट रखें और फिर से प्रस्तुत न करें।
नौकरी स्वीकार किया; प्रतीक्षा समय बाहरउसी नौकरी को पढ़ें या पुनर्प्राप्त करें। प्रतीक्षा जारी रखने के लिए एक और डाउनलोड न करें।
असफल होनाकार्य त्रुटि को पढ़ें और गंतव्य सेटिंग्स को ठीक करें या जानबूझकर पुनः प्रयास करने से पहले पहुँच लिखें।
मीडिया पढ़ने वापस लौटे 403भंडारण पढ़ने की अनुमतियों या आवेदन जारी लिंक की जाँच करें। FlashData API कुंजी S3 को अनलॉक नहीं करती है।
संकेतित परिणाम JSON समाप्त हो गयाफिर से नौकरी के परिणाम को इंगित करते हुए परिणाम को बनाए रखा जाता है। स्टोर्ड मीडिया आपकी बाल्टी के जीवन चक्र का अनुसरण करता है।
CLI · बचाया रन का निरीक्षण
flashdata runs show download-001 --json

अपने एजेंट को आउटपुट और डिलीवरी मानदंड दें

एजेंट कार्य · वीडियो, गंतव्य और बजट की आपूर्ति
मेरे बचाया मालिक का उपयोग करें और निजी भंडारण को कॉन्फ़िगर करें।
वीडियो और आउटपुट के लिए download-request.json पढ़ें; उन्हें चुपचाप नहीं बदल सकते।
अनुमोदित कार्य बजट के खिलाफ मूल्य निर्धारण और उपलब्ध क्रेडिट की जांच करें।
एक बार जमा करें, run/job ID को बचाएं, फिर उस काम को पूरा करने के लिए पढ़ें।
डिलीवरी रिकॉर्ड सहेजें। इसे संसाधित करने से पहले संग्रहीत वस्तु के आकार और MD5 को सत्यापित करें।
ऑब्जेक्ट स्थान, चयनित प्रारूप, सत्यापन परिणाम और वास्तविक उपयोग की रिपोर्ट करें।
यदि प्रस्तुतीकरण अनिश्चित है, तो सहेजे गए कार्यों का निरीक्षण करें; प्रतिस्थापन पहुंच या अन्य डाउनलोड नहीं करें।
भंडारण क्रेडेंशियल निजी रखें। केवल एप्लिकेशन के कॉन्फ़िगर एक्सेस कंट्रोल के माध्यम से मीडिया साझा करें।
Markdown