# YouTube Download latihan terbaik

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

Referensi kanonikal: https://flashdata.dev/id/docs/guides/youtube-download-guide
Diulang: 2026-11-04 oleh FlashData

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

## Mulai dengan apa yang Anda butuhkan tugas

| Tujuanmu | Gunakan |
| --- | --- |
| Ringkasan isi yang diucapkan atau buat indeks teks | Baca 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 audio | Audio- hanya keluaran. Hindari membawa trek video aplikasi Anda tidak digunakan. |
| Tampilkan suatu kutipan singkat | Set start_at dan end_at. Periksa bahwa keduanya berada dalam durasi video sumber. |
| Putar atau proses video | MP4 dengan audio dan sebuah topi resolusi cocok dengan aplikasi Anda; contoh yang digunakan <=720. |

- [Ringkasan dari takarir](https://flashdata.dev/id/docs/guides/youtube-summary/reference.md)
- [Inspeksi metadata video](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md#metadata)

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

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

### MP4 / 720p

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 pemrosesan audio lebih lanjut.

#### download-request.json

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


### 5klip -kedua

Sebuah kutipan MP4 dari 00:00:05 ke 00:00:10. Gunakan waktu yang cocok dengan video yang Anda pilih.

#### 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 opsi format](https://flashdata.dev/id/docs/sources/youtube_download/reference.md#parameters)

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

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

| Keputusan | Terapkan dengan cara ini |
| --- | --- |
| Perkiraan biaya | Gunakan creditsPerTb yang dikembalikan dan bytesPerUnit dengan perkiraan byte keluaran Anda. Unduh harga bukanlah biaya tetap per permintaan. |
| Lingkup kontrol | Pilih audio, klip atau topi resolusi sebelum pengiriman. Terapkan pekerjaan - jumlah dan pengeluaran aturan dalam aplikasi Anda. |
| Rekam muatan yang sebenarnya | Baca penggunaan dari pengiriman selesai. Penerimaan dapat menyimpan kredit sebelum upload mengendap; saldo saat ini bukan tutup pengeluaran perjob. |

### Cek gratis CLI

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

- [Pengaturan kunci pemilik](https://flashdata.dev/id/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP saldo dan harga](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md#balance)

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

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

| Kredensial | Tujuan |
| --- | --- |
| kunci FlashData | Kirim download dan membaca pekerjaannya dan pengiriman JSON. |
| Penyimpanan upload kredensial | Tulis media ke ember dan awalan yang diinginkan. |
| Identitas penyimpanan aplikasi | Baca objek privat atau keluarkan akses 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

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

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

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

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

### CLI

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

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


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

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

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

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

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.

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

##### Baca status 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, 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.

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

#### Pengiriman Fetch JSON menjaga API kunci 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 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

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

- [Verifikasi dan layani suatu objek privat](https://flashdata.dev/id/docs/guides/media-delivery-pipeline/reference.md#verify)

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

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

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

- [Hasil retensi dan media yang tersimpan](https://flashdata.dev/id/docs/guides/save-results/reference.md#media)

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

## Kembali dari tahap yang gagal

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

### CLI

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

- [Keputusan pemulihan](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)
- [Kesalahan dan kode status](https://flashdata.dev/id/docs/errors/reference.md)
- [Tugas berkala](https://flashdata.dev/id/docs/guides/recurring-tasks/reference.md)

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

## Berikan kriteria output dan pengiriman agenmu

### Tugas agen menyediakan video, tujuan dan anggaran

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

- [Bangun pipeline aplikasi](https://flashdata.dev/id/docs/guides/media-delivery-pipeline/reference.md)
