दस्तावेज़ देखें
गाइड
सही मीडिया आउटपुट चुनें, जो आप डाउनलोड करते हैं उसे नियंत्रित करें, और एक पूर्ण कार्य को एक उपयोगी निजी फ़ाइल में बदल दें।
इस पेज पर
अपने कार्य की जरूरत के बारे में क्या शुरू करें
| आपका लक्ष्य | उपयोग |
|---|---|
| बोली जाने वाली सामग्री को संक्षेप में प्रस्तुत करें या एक टेक्स्ट इंडेक्स बनाएं | पहले एक मौजूदा ट्रांसक्रिप्ट पढ़ें। केवल तभी ऑडियो डाउनलोड करें जब आपके वर्कफ़्लो को ऑडियो की जरूरत हो, जैसे कि एक अलग भाषण-टू-टेक्स्ट स्टेप। |
| प्रक्रिया भाषण या ऑडियो | केवल ऑडियो आउटपुट। वीडियो ट्रैक करने से बचने के लिए अपने आवेदन का उपयोग नहीं किया जाता है। |
| एक लघु अंश दिखाएं | सेट start_at और end_at। जांचें कि दोनों स्रोत वीडियो की अवधि के भीतर हैं। |
| प्ले या प्रक्रिया वीडियो | MP4 ऑडियो और एक संकल्प टोपी के साथ अपने आवेदन के लिए अनुकूल; उदाहरण <=720 का उपयोग करता है। |
आप चाहते हैं कि आउटपुट सहेजें
एक टैब चुनें और अपने पूरे अनुरोध को download-request.json के रूप में सहेजें। अपने स्रोत के लिए video_id बदलें। नीचे दिए गए सबमिशन कमांड इस फाइल को पढ़ते हैं, इसलिए ऑडियो चुनने या एक क्लिप वास्तविक अनुरोध को बदल देती है।
ऑडियो के साथ एक पूर्ण वीडियो, 720p पर छायांकित।
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}ऑडियो प्रोसेसिंग सुनने या आगे के लिए एक ऑडियो फ़ाइल।
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}एक MP4 00:00:05 से 00:00:10 तक छूट देता है। उस समय का उपयोग करें जो आपके चयनित वीडियो से मेल खाते हैं।
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720",
"start_at": "00:00:05",
"end_at": "00:00:10"
}
}मालिक पहुँच और बाइट आधारित मूल्य निर्धारण की जाँच करें
Bash और jq का उपयोग करें, साथ ही CLI प्रोफाइल या FLASHDATA_API_KEY के लिए HTTP प्रोफाइल को बचाया गया। कुंजी youtube_download अनुमति की जरूरत है। डाउनलोड करने के लिए मालिक की पहुंच की आवश्यकता है; अस्थायी परीक्षण का उपयोग इसमें शामिल नहीं है। CLI उदाहरण आपके डिफ़ॉल्ट प्रोफ़ाइल का उपयोग करते हैं; यदि आपका नाम है तो प्रत्येक कमांड में --profile नाम जोड़ें।
| निर्णय | इसे इस तरह से लागू करें |
|---|---|
| अनुमानित लागत | अपने अनुमानित आउटपुट बाइट्स के साथ लौटाए गए creditsPerTb और bytesPerUnit का उपयोग करें। मूल्य निर्धारण प्रति अनुरोध एक निश्चित शुल्क नहीं है। |
| नियंत्रण क्षेत्र | प्रस्तुत करने से पहले ऑडियो, एक क्लिप या एक रिज़ॉल्यूशन कैप चुनें। अपने आवेदन में नौकरी-काउंट और खर्च नियमों को लागू करें। |
| वास्तविक शुल्क रिकॉर्ड करें | पूरा वितरण से उपयोग पढ़ें। प्रवेश से पहले क्रेडिट जमा हो सकता है; वर्तमान शेष प्रति नौकरी खर्च करने वाली कैप नहीं है। |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonप्रत्येक आउटपुट के लिए एक निजी गंतव्य का उपयोग करें
अपने वास्तविक गंतव्य मूल्यों के साथ निजी तौर पर storage.json को सेव करें। इसे सोर्स कंट्रोल के बाहर रखें। प्रत्येक video/output संस्करण के लिए एक विशिष्ट object_prefix का उपयोग करें; विभिन्न आउटपुट के लिए एक उपसर्ग का उपयोग करने से एप्लिकेशन रिकॉर्ड्स को दोबारा मिलान करने के लिए कठिन बना देता है।
| क्रेज़ी | उद्देश्य |
|---|---|
| FlashData कुंजी | डाउनलोड करें और अपनी नौकरी और डिलीवरी JSON पढ़ने के लिए जमा करें। |
| भंडारण अपलोड क्रेडेंशियल | मीडिया को इच्छित बाल्टी और उपसर्ग के लिए लिखें। |
| आवेदन भंडारण पहचान | एक अधिकृत उपयोगकर्ता को निजी ऑब्जेक्ट या समस्या एक्सेस पढ़ें। |
{
"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"
}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
)(
set -eu
umask 077
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
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" | curl --fail-with-body --silent --show-error --max-time 70 \
--request POST 'https://data.flashdata.dev/v1/queries' \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Content-Type: application/json' \
--data-binary @- --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"
)(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
STATUS_URL=$(jq -er '.links[] | select(.rel == "self") | .href' download-submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)डिलीवरी रिकॉर्ड पढ़ें, फिर मीडिया तक पहुंचें
पूरा होने के बाद, आपको जमा करने के लिए उपयोग किए जाने वाले उसी रास्ते का उपयोग करके delivery.json को पुनः प्राप्त करें। हस्ताक्षरित परिणाम URL JSON को पुनः प्राप्त करता है; परिणाम [0].file_url अपने भंडारण में मीडिया की पहचान करता है। एक निजी file_url को आपके अनुप्रयोग द्वारा जारी किए गए अपनी स्टोरेज रीड पहचान या लिंक की आवश्यकता होती है।
(
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
)(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
jq -e '.job.status == "completed"' job.json >/dev/null
RESULTS_URL=$(jq -er '.links[] | select(.rel == "results") | .href' download-submission.json)
# Get the signed JSON URL without forwarding the API key to storage.
STORAGE_URL=$(curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
--output /dev/null --write-out '%{redirect_url}' "$RESULTS_URL")
: "${STORAGE_URL:?No signed result URL was returned}"
curl --fail-with-body --silent --show-error --compressed --max-time 70 \
"$STORAGE_URL" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)क्या दिया गया?
एक फ़ाइल स्थान, एक सकारात्मक file_size, एक MD5 और उपयोग की उम्मीद है। वितरित ऑब्जेक्ट के लिए रिकॉर्ड file_size; downloaded_bytes एक स्थानांतरण क्षेत्र है, जो उपयोग में अंतिम शुल्क के लिए प्रतिस्थापन नहीं है।
(
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 को बचाता है और मौजूदा स्थानीय फ़ाइल को ओवरराइट किए बिना इसका आकार और चेकसूम की जांच करता है।
(
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 समाप्त हो गया | फिर से नौकरी के परिणाम को इंगित करते हुए परिणाम को बनाए रखा जाता है। स्टोर्ड मीडिया आपकी बाल्टी के जीवन चक्र का अनुसरण करता है। |
flashdata runs show download-001 --jsonअपने एजेंट को आउटपुट और डिलीवरी मानदंड दें
मेरे बचाया मालिक का उपयोग करें और निजी भंडारण को कॉन्फ़िगर करें।
वीडियो और आउटपुट के लिए download-request.json पढ़ें; उन्हें चुपचाप नहीं बदल सकते।
अनुमोदित कार्य बजट के खिलाफ मूल्य निर्धारण और उपलब्ध क्रेडिट की जांच करें।
एक बार जमा करें, run/job ID को बचाएं, फिर उस काम को पूरा करने के लिए पढ़ें।
डिलीवरी रिकॉर्ड सहेजें। इसे संसाधित करने से पहले संग्रहीत वस्तु के आकार और MD5 को सत्यापित करें।
ऑब्जेक्ट स्थान, चयनित प्रारूप, सत्यापन परिणाम और वास्तविक उपयोग की रिपोर्ट करें।
यदि प्रस्तुतीकरण अनिश्चित है, तो सहेजे गए कार्यों का निरीक्षण करें; प्रतिस्थापन पहुंच या अन्य डाउनलोड नहीं करें।
भंडारण क्रेडेंशियल निजी रखें। केवल एप्लिकेशन के कॉन्फ़िगर एक्सेस कंट्रोल के माध्यम से मीडिया साझा करें।