# YouTube Download beste praktijken

Kies de juiste media-uitvoer, controleer wat u downloadt, en maak van een voltooide taak een bruikbaar privé-bestand.

Canonische referentie: https://flashdata.dev/nl/docs/guides/youtube-download-guide
Beoordeeld: 2026-11-04 door FlashData

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

## Begin met wat uw taak nodig heeft

| Je doel | Gebruik |
| --- | --- |
| Samengevat gesproken inhoud of een tekst-index bouwen | Lees eerst een bestaand transcript. Download audio alleen wanneer uw workflow de audio zelf nodig heeft, zoals een aparte spraak-naar-tekst stap. |
| Proces spraak of audio | Audio-only output. Vermijd het dragen van een video track uw toepassing niet gebruikt. |
| Een kort fragment tonen | Stel start_at en end_at in. Controleer of beide binnen de duur van de bron video's. |
| Video afspelen of verwerken | MP4 met audio en een resolutie cap geschikt voor uw toepassing; het voorbeeld gebruikt <=720. |

- [Samenvattingen van bijschriften](https://flashdata.dev/nl/docs/guides/youtube-summary/reference.md)
- [Videometadata inspecteren](https://flashdata.dev/nl/docs/guides/youtube-data-guide/reference.md#metadata)

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

## Sla de uitvoer op die u wilt

Kies één tabblad en sla het volledige verzoek op als download-request.json. Wijzig video_id voor uw bron. De submission commando's hieronder lezen dit bestand, dus het kiezen van audio of een clip verandert het werkelijke verzoek.

### MP4 / 720p

Een complete video met audio, afgetopt op 720p.

#### download-request.json

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


### MP3

Een audiobestand voor het luisteren of verdere audioverwerking.

#### download-request.json

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


### 5-second clip

Een MP4-fragment van 00:00:05 naar 00:00:10. Gebruik tijden die overeenkomen met uw geselecteerde video.

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


- [Alle opmaakopties](https://flashdata.dev/nl/docs/sources/youtube_download/reference.md#parameters)

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

## Controleer de toegang van de eigenaar en de op byte gebaseerde prijzen

Gebruik Bash en jq, plus een opgeslagen CLI-profiel of FLASHDATA_API_KEY voor HTTP. De sleutel heeft youtube_download toestemming nodig. Download vereist toegang tot de eigenaar; tijdelijke toegang tot trial bevat het niet. CLI voorbeelden gebruiken uw standaard profiel; voeg --profile NAAM toe aan elk commando als de jouwe een naam heeft.

| Besluit | Pas het zo toe |
| --- | --- |
| Schattingskosten | Gebruik de geretourneerde creditsPerTb en bytesPerUnit met uw geschatte output bytes. Downloadprijs is geen vast bedrag per aanvraag. |
| Controlegebied | Kies audio, een clip of een resolutie cap voordat u deze indient. Solliciteer job-count en uitgavenregels in je sollicitatie. |
| Registreer de werkelijke lading | Lees het gebruik van de voltooide levering. Toelating kan credits houden voordat de upload zich vestigt; lopende balans is geen per-job uitgavenplafond. |

### Gratis controles · CLI

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

- [Eigenaar key setup](https://flashdata.dev/nl/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP-balans en -prijzen](https://flashdata.dev/nl/docs/guides/credits-and-billing/reference.md#balance)

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

## Gebruik een privébestemming voor elke uitvoer

Bespaar storage.json privé met uw echte bestemmingswaarden. Hou het buiten de bron controle. Gebruik een aparte object_prefix voor elke video/output-versie; het hergebruiken van een prefix voor verschillende outputs maakt applicatie records moeilijker te verzoenen.

| Credentieel | Betreft |
| --- | --- |
| FlashData-sleutel | Stuur de download en lees zijn taak en levering JSON. |
| Opslag upload credential | Schrijf media naar de beoogde emmer en voorvoegsel. |
| Identiteit van de toepassingsopslag | Lees het privé-object of geef toegang tot een geautoriseerde gebruiker. |

### 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 · privébestand

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

- [Windows-bestandsrechten](https://flashdata.dev/nl/docs/guides/cli-automation/reference.md#storage)
- [Andere opslagleveranciers](https://flashdata.dev/nl/docs/sources/youtube_download/reference.md#storage)

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

## Stuur het opgeslagen verzoek één keer

Voer een tabblad na het opslaan van beide bestanden. Het commando injecteert storage.json via stdin en slaat download-submission.json op. Hou dit bonnetje maar. Met CLI, behouden dezelfde run ID voor een retry; gebruik een nieuwe ID alleen voor een opzettelijke nieuwe output. HTTP-inzendingen maken geen gebruik van het lokale run journal van de CLI.

### CLI

#### De gekozen uitvoer indienen

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

#### De gekozen uitvoer indienen

```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 aanvraagcontract](https://flashdata.dev/nl/docs/reference/realtime-and-async/reference.md#async)

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

### Valideer eerst met de CLI

Verwacht ok: true en data.dryRun: true. Dit controleert invoer en FlashData toegang zonder het indienen van een taak; het bewijst niet dat de upload referenties kunnen schrijven naar uw emmer.

#### Gratis droogloop

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

### Wacht op de bestaande taak

Het ontvangstbewijs is niet het mediabestand. CLI wacht; het HTTP commando leest eenmaal de status. Herhaal het lezen binnen uw deadline totdat voltooid of mislukt. Een lokale timeout annuleert de servertaak niet.

#### CLI

##### Wacht op de bewaarde taak

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


#### HTTP / cURL

##### Lees status één keer

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

## Lees de leveringsrecord, dan toegang tot de media

Na voltooiing, delivery.json ophalen met hetzelfde pad dat u gebruikt hebt om in te dienen. Het ondertekende resultaat URL haalt JSON op; resultaten[0].file_url identificeert de media in uw opslagruimte. Een privé file_url heeft uw opgeslagen lees-identiteit nodig of een link die door uw applicatie wordt uitgegeven.

### CLI

#### delivery.json opslaan

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

#### Levering ophalen JSON · de API sleutel uit opslagverzoeken houden

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

### Controleer wat geleverd is

Verwacht één bestandslocatie, een positieve file_size, een MD5 en gebruik. Record file_size voor het geleverde object; downloaded_bytes is een transfer veld, geen vervanging voor de uiteindelijke lading in gebruik.

#### delivery.json inspecteren

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

- [Een privé-object controleren en bedienen](https://flashdata.dev/nl/docs/guides/media-delivery-pipeline/reference.md#verify)

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

### Een lokale kopie controleren van S3

Stel OBJECT_KEY in op de geleverde mediasleutel van file_url, inclusief het voorvoegsel. Gebruik AWS CLI met leestoegang, jq en OpenSSL. Dit slaat media.mp4 of media.mp3 op volgens uw gekozen verzoek en controleert de grootte en het controlegetal zonder een bestaand lokaal bestand te overschrijven.

#### S3 gelezen · geen nieuwe FlashData query

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

- [Resultaat retentie en opgeslagen media](https://flashdata.dev/nl/docs/guides/save-results/reference.md#media)

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

## Herstellen van het stadium dat mislukt is

| Wat is er gebeurd? | Volgende actie |
| --- | --- |
| Indiening zonder bevestigde taak ID | Controleer de opgeslagen CLI-run of vraag geschiedenis. Houd de oorspronkelijke invoer en niet automatisch opnieuw indienen. |
| Taak aanvaard; wachttijd is verstreken | Lees of herstel dezelfde baan. Maak geen nieuwe download om verder te wachten. |
| Uploaden is mislukt | Lees de taakfout en repareer doelinstellingen of schrijf toegang voordat u het opzettelijk opnieuw probeert. |
| Media-lezen teruggegeven 403 | Controleer de leesrechten voor opslag of de applicatie-afgegeven link. De FlashData API sleutel ontgrendelt S3 niet. |
| Ondertekend resultaat JSON verlopen | Lees het resultaat van de taak opnieuw terwijl het resultaat behouden blijft. Opgeslagen media volgt de levenscyclus van uw emmer. |

### CLI · inspecteer de opgeslagen run

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

- [Terugvorderingsbeschikkingen](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md)
- [Fouten en statuscodes](https://flashdata.dev/nl/docs/errors/reference.md)
- [Terugkerende taken](https://flashdata.dev/nl/docs/guides/recurring-tasks/reference.md)

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

## Geef uw agent de output- en leveringscriteria

### Agent taak · leveren van de video, bestemming en budget

```text
Gebruik mijn opgeslagen eigenaar toegang en geconfigureerde privé-opslag.
Lees download-request.json voor de video en uitvoer; verander ze niet stil.
Check Download prijzen en beschikbare credits met het goedgekeurde taakbudget.
Eenmaal indienen, sla de run/job ID op en lees dan die taak tot voltooiing.
Bewaar het leveringsrecord. Controleer de grootte van het opgeslagen object en MD5 voordat u het verwerkt.
Rapporteer de locatie van het object, het gekozen formaat, het verificatieresultaat en het werkelijke gebruik.
Als de indiening onzeker is, inspecteer opgeslagen werk; maak geen vervangende toegang of een andere download.
Bewaar de gegevens van de opslag. Deel media alleen via de geconfigureerde toegangscontrole van de toepassing.
```

- [Bouw de toepassingspijplijn](https://flashdata.dev/nl/docs/guides/media-delivery-pipeline/reference.md)
