# 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.

Referensi boonical: https://flashdata.dev/ms/docs/guides/youtube-download-guide
Diulas: 2026-11-04 oleh FlashData

<a id="choose"></a>

## Mulailah dengan apa yang dibutuhkan tugasmu

| Tujuanmu | Guna |
| --- | --- |
| Takwid Summarize content yang diucapkan atau build a text indeks | Baca 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 audio | Keluaran hanya-Audio. Hindari membawa video trek aplikasi Anda tidak digunakan. |
| Tunjukkan kutipan singkat | start_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber. |
| Mainkan atau proses video | UM4 dengan audio dan topi resolusi sesuai dengan aplikasi Anda; contoh menggunakan <=720. |

- [Gambar-gambar dari gambar-gambar](https://flashdata.dev/ms/docs/guides/youtube-summary/reference.md)
- [Periksa data meta video Anda](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md#metadata)

<a id="formats"></a>

## 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.

### MP4 / 720p

Sebuah video lengkap dengan audio, ditutup pada 720p.

#### download-request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}
```


### MP3

Berkas audio untuk mendengarkan atau memproses audio lebih lanjut.

#### download-request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio",
    "output_format": "mp3"
  }
}
```


### Klip 5-detik

Sebuah kutipan MP4 dari 00:00:05 ke 00:00:10. Guna waktu yang cocok dengan video pilihanmu.

#### download-request.json

```json
{
  "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"
  }
}
```


- [Semua pilihan format](https://flashdata.dev/ms/docs/sources/youtube_download/reference.md#parameters)

<a id="prepare"></a>

## 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.

| Keputusan | Terapkan dengan cara ini |
| --- | --- |
| Biaya estimasi biaya biaya | Anda menggunakan creditsPerTb dan bytesPerUnit yang dikembalikan dengan perkiraan byte output. Pengenaan unduhan bukan biaya tetap per permintaan. |
| Skop pengendalian Skop Skop SCOG | Pilih audio, klip atau topi resolusi sebelum penyerahan. Terapkan pekerjaan-count dan menghabiskan aturan dalam aplikasi Anda. |
| Rekam muatan yang sebenarnya | Penggunaan 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

```bash
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json
```

- [Setup kunci Pemilik Couping](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP Keseimbangan dan harga](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md#balance)

<a id="storage"></a>

## 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 Kelayakan | Tujuan |
| --- | --- |
| Kunci FlashData | Ia mengirimkan JSON. |
| upload kredensial penyimpanan | Writing media ke baldi yang ditujukan dan awalan. |
| Identitas penyimpanan aplikasi | ¡Objek pribadi atau akses sengketa ke pengguna yang berwenang. |

### storage.json · S3

```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"
}
```

### Linux / macOS Berkas pribadi ····

```bash
chmod 600 storage.json
```

- [Keizinan berkas Windows](https://flashdata.dev/ms/docs/guides/cli-automation/reference.md#storage)
- [Penyedia penyimpanan lain](https://flashdata.dev/ms/docs/sources/youtube_download/reference.md#storage)

<a id="submit"></a>

## 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.

### CLI

#### Kirimkan output yang dipilih

```bash
(
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
)
```


### HTTP / cURL

#### Kirimkan output yang dipilih

```bash
(
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
)
```


- [Kontrak permintaan Async](https://flashdata.dev/ms/docs/reference/realtime-and-async/reference.md#async)

<a id="dry-run"></a>

### 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

```bash
(
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
)
```


<a id="status"></a>

### 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.

#### CLI

##### Tunggu untuk pekerjaan yang disimpan

```bash
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)
```


#### HTTP / cURL

##### Status baca sekali

```bash
(
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
)
```



<a id="delivery"></a>

## 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.

### CLI

#### Simpan delivery.json

```bash
(
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
)
```


### HTTP / cURL

#### Kiriman kutip JSON · simpan kunci API dari permintaan penyimpanan

```bash
(
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
)
```



<a id="inspect"></a>

### 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

```bash
(
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 dan sajikan objek pribadi](https://flashdata.dev/ms/docs/guides/media-delivery-pipeline/reference.md#verify)

<a id="verify-media"></a>

### 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

```bash
(
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'
)
```

- [Retensi hasil hasil hasil siri dan media yang disimpan](https://flashdata.dev/ms/docs/guides/save-results/reference.md#media)

<a id="operations"></a>

## Pemulihan dari panggung yang gagal

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

### CLI · · periksa yang disimpan dijalankan

```bash
flashdata runs show download-001 --json
```

- [Keputusan Pemulihan Liut](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)
- [Ralat dan kod status](https://flashdata.dev/ms/docs/errors/reference.md)
- [Tugas berulang](https://flashdata.dev/ms/docs/guides/recurring-tasks/reference.md)

<a id="agent"></a>

## Berikan agenmu kriteria output dan pengiriman

### Tugas agen agen · memasok video, tujuan dan anggaran

```text
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.
```

- [Bina saluran pipa aplikasi](https://flashdata.dev/ms/docs/guides/media-delivery-pipeline/reference.md)
