Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Panduan

Praktik terbaik YouTube Download

Pilih output media yang tepat, kendalikan apa yang Anda muat turun, dan ubah pekerjaan selesai menjadi berkas pribadi yang dapat digunakan.

Pada halaman ini

Mulailah dengan apa yang dibutuhkan tugasmu

TujuanmuGuna
Takwid Summarize content yang diucapkan atau build a text indeksBaca transkrip yang sudah ada terlebih dahulu. Unduh audio hanya ketika alur kerja Anda membutuhkan audio itu sendiri, seperti langkah berbicara-ke-teks yang terpisah.
Proses process wicara atau audioKeluaran hanya-Audio. Hindari membawa video trek aplikasi Anda tidak digunakan.
Tunjukkan kutipan singkatstart_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber.
Mainkan atau proses videoUM4 dengan audio dan topi resolusi sesuai dengan aplikasi Anda; contoh menggunakan <=720.

Simpan output yang kau inginkan

Pilih satu tab dan simpan seluruh permintaannya sebagai download-request.json. XAvideo_id untuk sumbermu. Perintah penyerahan di bawah membaca berkas ini, sehingga memilih audio atau klip mengubah permintaan yang sebenarnya.

Sebuah video lengkap dengan audio, ditutup pada 720p.

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

Periksa akses pemilik dan pengaturan berbasis byte

Use Bash dan jq, ditambah CLI yang disimpan profil atau FLASHDATA_API_KEY untuk HTTP. Kuncinya perlu izin youtube_download. Unduhan COMUD membutuhkan akses pemilik; akses pengadilan sementara tidak termasuk. Contoh CLI menggunakan profil default anda; tambahkan NAMA --profile ke setiap perintah jika anda bernama.

KeputusanTerapkan dengan cara ini
Biaya estimasi biaya biayaAnda menggunakan creditsPerTb dan bytesPerUnit yang dikembalikan dengan perkiraan byte output. Pengenaan unduhan bukan biaya tetap per permintaan.
Skop pengendalian Skop Skop SCOGPilih audio, klip atau topi resolusi sebelum penyerahan. Terapkan pekerjaan-count dan menghabiskan aturan dalam aplikasi Anda.
Rekam muatan yang sebenarnyaPenggunaan bacaan dari pengiriman yang telah selesai. Kecanduan KANTOR dapat memegang kredit sebelum unggah selesai; saldo saat ini bukan tutup pengeluaran per-tugas.
Pemeriksaan gratis · CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Use sebuah destinasi privat untuk setiap keluaran

Simpan storage.json secara pribadi dengan nilai tujuan nyata Anda. Tetap di luar kendali sumber. Diafine menggunakan object_prefix yang berbeda untuk setiap versi video/output; menggunakan awalan untuk keluaran yang berbeda membuat catatan aplikasi lebih sulit untuk didamaikan.

Bukti Bukti Bukti KelayakanTujuan
Kunci FlashDataIa mengirimkan JSON.
upload kredensial penyimpananWriting media ke baldi yang ditujukan dan awalan.
Identitas penyimpanan aplikasi¡Objek pribadi atau akses sengketa ke pengguna yang berwenang.
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 Berkas pribadi ····
chmod 600 storage.json

Serahkan permintaan yang disimpan sekali

Jalankan satu tab setelah menyimpan kedua berkas. Perintah command injects storage.json melalui stdin dan menyimpan download-submission.json. Habel menyimpan penerimaan ini. Dengan CLI, mempertahankan menjalankan ID yang sama untuk mencoba lagi; menggunakan ID baru hanya untuk keluaran baru yang disengaja. Pengiriman HTTP tidak menggunakan jurnal run lokal CLI.

Kirimkan output yang dipilih
(
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
)

Kesahihan pertama dengan CLI

ok: true dan data.dryRun: true. Ini memeriksa input dan akses FlashData tanpa mengirimkan pekerjaan; itu tidak membuktikan kelayakan muat naik dapat menulis ke ember Anda.

Kering kering bebas kering
(
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
)

Tunggu pekerjaan yang sudah ada

Penerimaan penyerahan Haqq bukanlah berkas media. Perintah CLI menunggu; perintah HTTP membaca status sekali. Mengulangi bacaan dalam tenggat waktu Anda sampai selesai atau gagal. KELUARANGAN lokal tidak membatalkan pekerjaan server.

Tunggu untuk pekerjaan yang disimpan
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

Baca catatan pengiriman, lalu akses media

Setelah selesai, ambil kembali delivery.json menggunakan jalur yang sama yang digunakan untuk mengirimkan. Hasil yang ditandatangani URL memperoleh JSON; hasil[0].file_url mengidentifikasi media dalam penyimpanan Anda. Sebuah file_url pribadi membutuhkan identitas baca penyimpanan Anda atau link yang dikeluarkan oleh aplikasi Anda.

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

Periksa apa yang telah disampaikan

Expect satu lokasi berkas, positif file_size, sebuah MD5 dan penggunaan. Catatan file_size untuk objek yang disampaikan; downloaded_bytes adalah medan transfer, bukan pengganti untuk biaya akhir dalam penggunaan.

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

Sahkan sebuah salinan lokal dari S3

OBJECT_KEY ke kunci media yang disampaikan dari file_url, termasuk prefiksnya. AWS Gunakan CLI dengan akses baca, jq dan OpenSSL. Ini menyimpan media.mp4 atau media.mp3 sesuai permintaan yang Anda pilih dan memeriksa ukuran dan checksum tanpa menimpa berkas lokal yang ada.

Baca S3 · tidak ada pertanyaan FlashData baru
(
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'
)

Pemulihan dari panggung yang gagal

Apa yang terjadi?Tindakan berikutnya
Submisi berakhir tanpa konfirmasi pekerjaan IDPeriksalah CLI yang disimpan atau sejarah permintaan. Tetap masukan asli dan jangan otomatis menyerahkan lagi.
Tugas diterima; menunggu waktu habisBaca atau pulihkan pekerjaan yang sama. Jangan membuat unduhan lain untuk terus menunggu.
Gagal memuat-naikMembaca kesalahan kerja dan memperbaiki pengaturan tujuan atau akses tulis sebelum mencoba lagi secara sengaja.
Media baca dikembalikan 403Periksa izin baca penyimpanan atau link terisuasi aplikasi. Kunci FlashData API tidak membuka kunci S3.
Hasil signed JSON berakhirBacalah hasil pekerjaan titik akhir lagi sementara hasilnya tetap dipertahankan. Media penyimpanan baldi mengikuti daur hidup ember Anda.
CLI · · periksa yang disimpan dijalankan
flashdata runs show download-001 --json

Berikan agenmu kriteria output dan pengiriman

Tugas agen agen · memasok video, tujuan dan anggaran
Aku menggunakan akses pemilik yang telah kusimpan dan penyimpanan pribadi yang telah dikonfigurasi.
Baca download-request.json untuk video dan output; jangan ubah mereka diam-diam.
Voked Check Download menetapkan harga dan kredit yang tersedia terhadap anggaran tugas yang disetujui.
Serahkan sekali, simpan run/job ID, kemudian baca pekerjaan itu untuk diselesaikan.
Simpan catatan pengirimannya. Sahkan ukuran objek tersimpan dan MD5 sebelum memprosesnya.
WANITA Melaporkan lokasi objek, format yang dipilih, hasil verifikasi dan penggunaan yang sebenarnya.
Jika penyerahan tidak pasti, inspeksi pekerjaan yang disimpan; jangan membuat akses penggantian atau unduhan lain.
Simpan bukti penyimpanan pribadi. Kongsi media hanya melalui kontrol akses yang telah dikonfigurasi oleh aplikasi.