تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

الأدلة

YouTube Download أفضل الممارسات

اختر الإنتاج الإعلامي الصحيح، وتحكم في ما تحمله، وتحويل العمل المكتمل إلى ملف خاص قابل للاستخدام.

في هذه الصفحة

ابدأ بما تحتاجه مهمتك

هدفكالاستخدام
Summarize spoken content or build a text indexاقرأ نسخة قائمة أولاً تنزيل الصوت فقط عندما يحتاج تدفق العمل الخاص بك الصوت نفسه، مثل خطوة منفصلة للكلمات إلى النص.
خطاب العملية أو الصوتالناتج الصوتي فقط. تجنب حمل شريط فيديو لا يستخدمه طلبك
أظهر مقتطف قصيرSet start_at and end_at. تحقق من أن كلاهما في غضون فترة الفيديو المصدر.
تشغيل أو تجهيز الفيديوMP4 مع كبسولة سمعية وحلية تناسب تطبيقك؛ ويستخدم المثال <=720.

احفظ الناتج الذي تريده

اختر ورقة واحدة ووفر كامل طلبها download-request.json. التغيير video_id لمصدرك وتقرأ أوامر التقديم الواردة أدناه هذا الملف، وبالتالي فإن اختيار مقطع صوتي أو مقطعي يغير الطلب الفعلي.

فيديو كامل مع الصوت، مجهز في 720ب.

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

مراقبة وصول المالك والتسعير من قبل

Use Bash and jq, plus a save CLI profile or FLASHDATA_API_KEY for 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 على انفراد مع قيم الوجهة الحقيقية أبقها خارج سيطرة المصدر (ج) استخدام مواصفات مصممة من طراز object_prefix لكل نسخة من صيغة video/output؛ وإعادة استخدام الرقم القياسي لمختلف النواتج يجعل من الصعب التوفيق بين سجلات التطبيقات.

الخليةالغرض
مفتاح 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 · private file
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
)

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"
)

اقرأ سجل التوصيل، ثم ابلغ وسائل الاعلام

بعد completed، استرجع delivery.json بالطريقة نفسها المستخدمة للإرسال. يجلب رابط النتيجة الموقّع JSON؛ ويحدد results[0].file_url الوسائط داخل تخزينك. يتطلب file_url الخاص هوية لقراءة التخزين أو رابطًا يصدره تطبيقك.

Save 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 وusage. سجّل file_size للكائن المُسلَّم؛ أما downloaded_bytes فهو حقل نقل وليس بديلًا عن الرسم النهائي في usage.

Inspect 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 · no new FlashData query
(
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وقراءة نتيجة العمل مرة أخرى مع الاحتفاظ بالنتيجة. وسائل الإعلام المخزنة تتبع دورة حياة الدلو
CLI ; inspect the Save run
flashdata runs show download-001 --json

أعطِ عميلكَ معايير الإنتاج والتوصيل

مهمة العميلة: توفير الفيديو والمقصد والميزانية
استعملي مالكي المنقذ واصنعي مخزناً خاصاً
اقرأ download-request.json للفيديو والناتج؛ لا تغيرها بصمت.
التحقق من تسعير الحمولة والأرصدة الدائنة المتاحة مقابل ميزانية العمل المعتمدة.
استسلمي مرة واحدة، انقذي run/job IDثم قرأ هذه الوظيفة حتى النهاية
احتفظ بسجل التسليم التحقق من حجم الجسم المخزن و MD5 قبل تجهيزها
Report the object location, selected format, verification result and actual usage.
وإذا كان التقديم غير مؤكد، فإن التفتيش على العمل المنقذ؛ ولا يخلق إمكانية الحصول على الاستبدال أو تحميل آخر.
حافظ على أوراق التخزين الخاصة تبادل وسائل الإعلام فقط من خلال تطبيق نظام مراقبة الدخول.