ข้ามไปยังเนื้อหา
TH
รับคีย์ 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 ส่วนตัวกับเป้าหมายที่แท้จริงของคุณ เก็บมันอยู่นอกการควบคุมแหล่งที่มา ใช้แยกต่างหาก 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 แฟ้มส่วนตัวของ eH
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; results[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 จากการร้องขอที่เลือก และตรวจสอบขนาดและ checksum โดยไม่ต้องเขียนแฟ้มภายในระบบที่มีอยู่มากเกินไป

S3 อ่านที่ ไม่ปรากฏใหม่ 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

ให้ตัวแทนของคุณแสดงและส่ง

Aagent job play effect วีดีโอ, จุดหมายปลายทาง และงบประมาณ
ใช้ความเป็นเจ้าของของฉันที่บันทึกไว้ และปรับแต่งการจัดเก็บส่วนบุคคล
อ่าน download-request.json สําหรับวิดีโอและการแสดงผล; อย่าเปลี่ยนพวกเขาเงียบ
Check downloads prizes and access ที่มีอยู่ต่องบประมาณงานที่อนุญาต
ยอมแพ้ครั้งเดียว, บันทึก run/job IDอ่านงานนั้นให้เสร็จ
บันทึกการส่งมอบ ตรวจสอบขนาดของวัตถุที่เก็บไว้ MD5 ก่อนที่จะประมวลผลมัน
รายงานตําแหน่งวัตถุ, รูปแบบการเลือก, ผลการตรวจสอบ และการใช้งานจริง
หากการส่งข้อมูลไม่แน่ใจ ให้ตรวจสอบการทํางานที่ถูกบันทึกไว้ อย่าสร้างการเข้าถึงใหม่ หรือการดาวน์โหลดอื่น
เก็บบันทึกเอกสารส่วนตัวไว้ ใช้สื่อร่วมกันผ่านทางการควบคุมการเข้าใช้ของโปรแกรมเท่านั้น