Documentatie bekijken
Handleidingen
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 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. |
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.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio_video",
"output_format": "mp4",
"video_quality": "<=720"
}
}Een audiobestand voor het luisteren of verdere audioverwerking.
{
"source": "youtube_download",
"video_id": "jNQXAC9IVRw",
"params": {
"download_type": "audio",
"output_format": "mp3"
}
}Een MP4-fragment van 00:00:05 naar 00:00:10. Gebruik tijden die overeenkomen met uw geselecteerde video.
{
"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"
}
}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. |
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --jsonGebruik 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_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"
}chmod 600 storage.jsonStuur 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.
(
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
)(
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
)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.
(
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.
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)(
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
)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.
(
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
)(
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
)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.
(
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.
(
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 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. |
flashdata runs show download-001 --jsonGeef uw agent de output- en leveringscriteria
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.