Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Panduan

YouTube Download latihan terbaik

Pilih keluaran media yang tepat, kontrol apa yang Anda unduh, dan ubah pekerjaan selesai menjadi berkas privat yang dapat dipakai.

Di halaman ini

Mulai dengan apa yang Anda butuhkan tugas

TujuanmuGunakan
Ringkasan isi yang diucapkan atau buat indeks teksBaca transkrip yang sudah ada dulu. Unduh audio hanya ketika memutar aliran kerja Anda memerlukan audio itu sendiri, seperti langkah cepat -to- teks yang terpisah.
Pidato proses atau audioAudio- hanya keluaran. Hindari membawa trek video aplikasi Anda tidak digunakan.
Tampilkan suatu kutipan singkatSet start_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber.
Putar atau proses videoMP4 dengan audio dan sebuah topi resolusi cocok dengan aplikasi Anda; contoh yang digunakan <=720.

Simpan keluaran yang Anda inginkan

Pilih satu tab dan simpan seluruh permintaannya sebagai download-request.json. Ubah video_id untuk sumber Anda. Perintah pengiriman di bawah ini membaca berkas ini, jadi memilih audio atau klip mengubah permintaan yang sebenarnya.

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 nilai berdasarkan

Gunakan Bash dan jq, ditambah sebuah profil CLI yang disimpan atau FLASHDATA_API_KEY untuk HTTP. Kunci membutuhkan izin youtube_download. Unduh membutuhkan akses pemilik; akses percobaan sementara tidak termasuk itu. CLI contoh menggunakan profil baku Anda; tambahkan --profile NAMA ke setiap perintah jika nama Anda bernama.

KeputusanTerapkan dengan cara ini
Perkiraan biayaGunakan creditsPerTb yang dikembalikan dan bytesPerUnit dengan perkiraan byte keluaran Anda. Unduh harga bukanlah biaya tetap per permintaan.
Lingkup kontrolPilih audio, klip atau topi resolusi sebelum pengiriman. Terapkan pekerjaan - jumlah dan pengeluaran aturan dalam aplikasi Anda.
Rekam muatan yang sebenarnyaBaca penggunaan dari pengiriman selesai. Penerimaan dapat menyimpan kredit sebelum upload mengendap; saldo saat ini bukan tutup pengeluaran perjob.
Cek gratis CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Gunakan tujuan privat untuk setiap keluaran

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

KredensialTujuan
kunci FlashDataKirim download dan membaca pekerjaannya dan pengiriman JSON.
Penyimpanan upload kredensialTulis media ke ember dan awalan yang diinginkan.
Identitas penyimpanan aplikasiBaca objek privat atau keluarkan akses 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
chmod 600 storage.json

Ajukan permintaan yang disimpan sekali

Jalankan satu tab setelah menyimpan kedua berkas. Perintah disuntik storage.json melalui stdin dan menyimpan download-submission.json. Simpan tanda terima ini. Dengan CLI, pertahankan run yang sama ID untuk percobaan ulang; gunakan ID baru hanya untuk output baru yang disengaja. Pengiriman HTTP tidak menggunakan jurnal lokal CLI.

Kirim keluaran 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
)

Validasi pertama dengan CLI

Diharapkan ok: true dan data.dryRun: true. Ini memeriksa masukan dan FlashData akses tanpa mengirimkan pekerjaan; ini tidak membuktikan bahwa upload kredensial dapat menulis ke ember Anda.

Uji coba bebas
(
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

Tanda terima pengiriman bukan berkas media. CLI menunggu, perintah HTTP membaca status sekali. Ulangi dalam tenggat waktu anda sampai selesai atau gagal. Tenggat lokal tidak membatalkan tugas 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, kemudian akses media

Setelah selesai, mengambil delivery.json menggunakan jalur yang sama yang Anda gunakan untuk mengirimkan. Hasil ditandatangani URL mengambil JSON; hasil [0] .file_url mengidentifikasi media di penyimpanan Anda. Seorang pribadi file_url membutuhkan identitas pembacaan penyimpanan anda atau sebuah 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 dikirimkan

Mengharapkan satu lokasi berkas, positif file_size, sebuah MD5 dan penggunaan. Rekam file_size untuk objek yang disampaikan; downloaded_bytes adalah bidang transfer, bukan pengganti untuk muatan akhir dalam penggunaan.

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

Verifikasi salinan lokal dari S3

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

S3 tidak ada kueri 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'
)

Kembali dari tahap yang gagal

Apa yang terjadi?Aksi berikutnya
Submission timeout dengan tidak ada pekerjaan dikonfirmasi IDInspeksi yang disimpan CLI jalankan atau riwayat permintaan. Pertahankan input asli dan jangan secara otomatis mengirimkan lagi.
Tugas diterima; menunggu timeoutBaca atau ambil pekerjaan yang sama. Jangan buat download lain untuk melanjutkan menunggu.
Pengunggah gagalBaca kesalahan pekerjaan dan perbaiki pengaturan tujuan atau tulis akses sebelum secara sengaja mencoba kembali.
Pembacaan media mengembalikan 403Periksa izin baca penyimpanan atau aplikasi-diterbitkan link. Kunci FlashData API tidak membuka kunci S3.
Hasil tertanda JSON kadaluarsaBaca akhir pekerjaan lagi sementara hasilnya dipertahankan. Media yang tersimpan mengikuti tulang hidupmu.
CLI
flashdata runs show download-001 --json

Berikan kriteria output dan pengiriman agenmu

Tugas agen menyediakan video, tujuan dan anggaran
Gunakan akses pemilik yang tersimpan dan konfigurasi penyimpanan pribadi.
Baca download-request.json untuk video dan keluaran; jangan ubah diam-diam.
Periksa nilai unduhan dan kredit yang tersedia terhadap anggaran tugas yang disetujui.
Kirim sekali, menyimpan run/job ID, kemudian membaca bahwa pekerjaan untuk menyelesaikan.
Simpan catatan pengirimannya. Verifikasi ukuran objek yang disimpan dan MD5 sebelum memprosesnya.
Laporkan lokasi objek, format yang dipilih, hasil verifikasi dan penggunaan aktual.
Bila penyerahan tidak pasti, pemeriksaan disimpan; jangan membuat akses pengganti atau download lain.
Simpan mandat penyimpanan pribadi. Berbagi media hanya melalui aplikasi yang dikonfigurasi kontrol akses.