تصفح الوثائق
الأدلة
اختر الإنتاج الإعلامي الصحيح، وتحكم في ما تحمله، وتحويل العمل المكتمل إلى ملف خاص قابل للاستخدام.
في هذه الصفحة
ابدأ بما تحتاجه مهمتك
| هدفك | الاستخدام |
|---|---|
| Summarize spoken content or build a text index | اقرأ نسخة قائمة أولاً تنزيل الصوت فقط عندما يحتاج تدفق العمل الخاص بك الصوت نفسه، مثل خطوة منفصلة للكلمات إلى النص. |
| خطاب العملية أو الصوت | الناتج الصوتي فقط. تجنب حمل شريط فيديو لا يستخدمه طلبك |
| أظهر مقتطف قصير | Set start_at and end_at. تحقق من أن كلاهما في غضون فترة الفيديو المصدر. |
| تشغيل أو تجهيز الفيديو | MP4 مع كبسولة سمعية وحلية تناسب تطبيقك؛ ويستخدم المثال <=720. |
احفظ الناتج الذي تريده
اختر ورقة واحدة ووفر كامل طلبها download-request.json. التغيير video_id لمصدرك وتقرأ أوامر التقديم الواردة أدناه هذا الملف، وبالتالي فإن اختيار مقطع صوتي أو مقطعي يغير الطلب الفعلي.
فيديو كامل مع الصوت، مجهز في 720ب.
{
"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"
}
}An MP4 excerpt from 00:00:05 to 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"
}
}مراقبة وصول المالك والتسعير من قبل
Use Bash and jq, plus a save CLI profile or FLASHDATA_API_KEY for HTTP. الاحتياجات الرئيسية youtube_download إذن. ويستلزم التحميل وصول المالك؛ ولا يشمل ذلك الوصول المؤقت إلى التجربة. CLI استعملي بعض الأمثلة ملفك الافتراضي --profile نيم إلى كل أمر إذا كان اسمك.
| مقرر | تطبيقه بهذه الطريقة |
|---|---|
| التكلفة التقديرية | إستعملْ المعادَ creditsPerTb و bytesPerUnit مع تقديرات ناتجك. تسعير الحمولة ليس شحنة ثابتة لكل طلب. |
| نطاق الرقابة | اختر الصوت، أو مقطع أو قبعة حل قبل تقديمه. تطبيق نظام حساب العمل و تطبيق القواعد في تطبيقك |
| تسجيل الشحنة الفعلية | اقرأي الإستخدام من التسليم المكتمل ويجوز أن يقيد القبول الائتمانات قبل أن يستقر عبء العمل؛ والتوازن الحالي ليس حدا أقصى للإنفاق على العمل الواحد. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonاستخدام وجهة خاصة لكل ناتج
انقذوا storage.json على انفراد مع قيم الوجهة الحقيقية أبقها خارج سيطرة المصدر (ج) استخدام مواصفات مصممة من طراز object_prefix لكل نسخة من صيغة video/output؛ وإعادة استخدام الرقم القياسي لمختلف النواتج يجعل من الصعب التوفيق بين سجلات التطبيقات.
| الخلية | الغرض |
|---|---|
| مفتاح 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، احتفظ بمعرّف التنفيذ نفسه عند إعادة المحاولة؛ واستخدم معرّفًا جديدًا فقط لمخرج جديد مقصود. لا تستخدم إرسالات 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
)Validate first with the CLI
Expect ok: true and 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 الحالة مرة واحدة. كرر القراءة ضمن مهلة عملك حتى completed أو failed. انتهاء المهلة محليًا لا يلغي مهمة الخادم.
(
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
)اقرأ سجل التوصيل، ثم ابلغ وسائل الاعلام
بعد completed، استرجع delivery.json بالطريقة نفسها المستخدمة للإرسال. يجلب رابط النتيجة الموقّع JSON؛ ويحدد results[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 وusage. سجّل file_size للكائن المُسلَّم؛ أما downloaded_bytes فهو حقل نقل وليس بديلًا عن الرسم النهائي في usage.
(
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 تشغيل أو طلب التاريخ. احتفظ بالمدخل الأصلي ولا تقدمه تلقائيا مرة أخرى. |
| الوظائف المقبولة؛ الانتظار | اقرأ أو استرجع نفس العمل لا تخلق تحميلاً آخر لتستمر بالانتظار |
| تم تفريغها | اقرأ خطأ العمل واصلح أماكن المقصد أو اكتب الوصول قبل إعادة البحث عن قصد. |
| Media read returned 403 | يقرأ التخزين الشيك إذناً أو الرابط الذي يصدره الطلب. The FlashData API المفتاح لا يفتح S3. |
| نتيجة موقّعة انقضت صلاحية JSON | وقراءة نتيجة العمل مرة أخرى مع الاحتفاظ بالنتيجة. وسائل الإعلام المخزنة تتبع دورة حياة الدلو |
flashdata runs show download-001 --jsonأعطِ عميلكَ معايير الإنتاج والتوصيل
استعملي مالكي المنقذ واصنعي مخزناً خاصاً
اقرأ download-request.json للفيديو والناتج؛ لا تغيرها بصمت.
التحقق من تسعير الحمولة والأرصدة الدائنة المتاحة مقابل ميزانية العمل المعتمدة.
استسلمي مرة واحدة، انقذي run/job IDثم قرأ هذه الوظيفة حتى النهاية
احتفظ بسجل التسليم التحقق من حجم الجسم المخزن و MD5 قبل تجهيزها
Report the object location, selected format, verification result and actual usage.
وإذا كان التقديم غير مؤكد، فإن التفتيش على العمل المنقذ؛ ولا يخلق إمكانية الحصول على الاستبدال أو تحميل آخر.
حافظ على أوراق التخزين الخاصة تبادل وسائل الإعلام فقط من خلال تطبيق نظام مراقبة الدخول.