Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Handleidingen

YouTube Download beste praktijken

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

Op deze pagina

Begin met wat uw taak nodig heeft

Je doelGebruik
Samengevat gesproken inhoud of een tekst-index bouwenLees 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 audioAudio-only output. Vermijd het dragen van een video track uw toepassing niet gebruikt.
Een kort fragment tonenStel start_at en end_at in. Controleer of beide binnen de duur van de bron video's.
Video afspelen of verwerkenMP4 met audio en een resolutie cap geschikt voor uw toepassing; het voorbeeld gebruikt <=720.

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.

Een complete video met audio, afgetopt op 720p.

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

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.

BesluitPas het zo toe
SchattingskostenGebruik de geretourneerde creditsPerTb en bytesPerUnit met uw geschatte output bytes. Downloadprijs is geen vast bedrag per aanvraag.
ControlegebiedKies audio, een clip of een resolutie cap voordat u deze indient. Solliciteer job-count en uitgavenregels in je sollicitatie.
Registreer de werkelijke ladingLees 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
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

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.

CredentieelBetreft
FlashData-sleutelStuur de download en lees zijn taak en levering JSON.
Opslag upload credentialSchrijf media naar de beoogde emmer en voorvoegsel.
Identiteit van de toepassingsopslagLees het privé-object of geef toegang tot een geautoriseerde gebruiker.
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 · privébestand
chmod 600 storage.json

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.

De gekozen uitvoer indienen
(
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
)

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

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.

Wacht op de bewaarde taak
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

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.

delivery.json opslaan
(
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
)

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

Herstellen van het stadium dat mislukt is

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

Geef uw agent de output- en leveringscriteria

Agent taak · leveren van de video, bestemming en budget
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.