Przejdź do treści
PL
Uzyskaj klucz API
Przeglądaj dokumentację

Poradniki

Najlepsze praktyki YouTube Download

Wybierz odpowiednie wyjście multimedialne, kontroluj co pobierasz i zamień ukończone zadanie w użyteczny plik prywatny.

Na tej stronie

Zacznij od tego, czego potrzebuje Twoje zadanie

Twój celStosowanie
Podsumowanie treści mówionej lub utworzenie indeksu tekstowegoNajpierw przeczytaj istniejący transkrypt. Pobierz dźwięk tylko wtedy, gdy Twój przepływ pracy wymaga samego dźwięku, takie jak oddzielny krok przemówień- to- tekst.
Przemowa procesowa lub audioWyjście tylko dla audio. Unikaj posiadania ścieżki wideo, której nie używa aplikacja.
Pokaż krótki fragmentUstaw start_at i end_at. Sprawdź, czy oba są w czasie trwania nagrania.
Odtwarzanie lub przetwarzanie wideoMP4 z dźwiękiem i kapslem rozdzielczości dopasowanym do Twojej aplikacji; przykład wykorzystuje <=720.

Zapisz wyjście, które chcesz

Wybierz jedną kartę i zapisz jej całe żądanie jako download-request.json. Zmień video_id dla swojego źródła. Polecenia przekazania poniżej przeczytaj ten plik, więc wybór audio lub klip zmienia rzeczywiste żądanie.

Kompletny film z audio, w rozdzielczości 720p.

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

Sprawdź dostęp właściciela i ceny bajtowe

Należy użyć Bash i jq oraz zapisanego profilu CLI lub FLASHDATA_API_KEY dla HTTP. Klucz wymaga zezwolenia youtube_download. Pobieranie wymaga dostępu właściciela; czasowy dostęp próbny nie obejmuje go. Przykłady CLI używają domyślnego profilu; dodaj --profile NAME do każdego polecenia, jeśli Twoje jest nazwane.

DecyzjaZastosuj to w ten sposób
Szacunkowy kosztUżyj zwróconego creditsPerTb i bytesPerUnit z szacowanymi bajtami wyjściowymi. Cena pobierana nie jest stałą opłatą za każde żądanie.
Zakres kontroliPrzed złożeniem należy wybrać dźwięk, klip lub nasadkę rozdzielczości. Zastosuj zasady liczenia pracy i wydatków w aplikacji.
Zapis rzeczywistej opłatyPrzeczytaj użycie z zakończonej dostawy. Wstęp może zawierać kredyty przed ustawieniem wysyłania; saldo bieżące nie jest pułapem wydatków na pracę.
Bezpłatne kontrole · CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Użyj prywatnego celu dla każdego wyjścia

Zapisz storage.json prywatnie z prawdziwymi wartościami docelowymi. Trzymaj to poza kontrolą źródła. Użyj odrębnego object_prefix dla każdej wersji video/output; ponowne użycie przedrostka dla różnych wyjść sprawia, że rekordy aplikacji trudniej pogodzić.

KredytoweCel
Klawisz FlashDataPrześlij pobranie i przeczytaj jego zadanie i dostawy JSON.
Przechowywanie wysyłania uwierzytelniającegoNapisz media do zamierzonego wiadra i przedrostka.
Identyfikacja wniosku o przechowywanieOdczytaj obiekt prywatny lub wydaj dostęp do autoryzowanego użytkownika.
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 · plik prywatny
chmod 600 storage.json

Prześlij raz zapisane żądanie

Uruchom jedną kartę po zapisaniu obu plików. Polecenie wstrzykuje storage.json przez stdin i zapisuje download-submission.json. Zatrzymaj ten paragon. Z CLI, zachować ten sam bieg ID dla ponownego wypróbowania; używać nowego ID tylko dla zamierzonego nowego wyjścia. Zgłoszenia HTTP nie korzystają z lokalnego dziennika przebiegu CLI.

Prześlij wybrane wyjście
(
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
)

Zatwierdzenie najpierw za pomocą CLI

Oczekuj ok: true i data.dryRun: true. Sprawdza to wejście i dostęp do FlashData bez składania pracy; nie dowodzi, że dane uwierzytelniające mogą pisać do Twojego wiadra.

Bezpłatny bieg suchy
(
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
)

Czekaj na istniejącą pracę

Poświadczenie złożenia nie jest plikiem medialnym. CLI czeka; komenda HTTP odczytuje status raz. Odczyt należy powtórzyć w terminie do zakończenia lub niepowodzenia. Lokalny timeout nie anuluje zadania serwera.

Czekaj na uratowaną pracę
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

Przeczytaj zapis dostawy, a następnie uzyskać dostęp do mediów

Po zakończeniu pobrać delivery.json przy użyciu tej samej ścieżki, którą składałeś. Podpisany wynik URL pobiera JSON; wyniki [0] .file_url identyfikuje nośniki w Twoim magazynie. Prywatny file_url potrzebuje Twojej tożsamości odczytu z pamięci lub odnośnika wydanego przez Twoją aplikację.

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

Sprawdź, co dostarczono

Oczekuj lokalizacji jednego pliku, pozytywnego file_size, MD5 i wykorzystania. Zapis file_size dla dostarczonego obiektu; downloaded_bytes to pole transferowe, a nie zamiennik opłaty końcowej w użyciu.

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

Weryfikacja lokalnej kopii z S3

Ustaw OBJECT_KEY na dostarczony klucz medialny z file_url, w tym przedrostek. Użyj AWS CLI z dostępem do odczytu, jq i OpenSSL. To zapisuje media.mp4 lub media.mp3 zgodnie z wybranym żądaniem i sprawdza jego rozmiar i sumę kontrolną bez nadpisywania istniejącego pliku lokalnego.

S3 odczyt · brak nowego zapytania FlashData
(
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'
)

Odzyskanie ze sceny, która zawiodła

Co się stało?Następna akcja
Złożenie w czasie bez potwierdzonej pracy IDSprawdź zapisany bieg CLI lub historię żądania. Zachowaj oryginalne dane wejściowe i nie poddawaj się automatycznie.
Zaakceptowana praca; czas oczekiwaniaOdczyt lub odzyskanie tej samej pracy. Nie tworzyć kolejnego pobierania, aby kontynuować czekanie.
Wysyłanie nie powiodło sięOdczytaj błąd zadania i ustaw ustawienia docelowe lub pisz dostęp przed umyślnym ponownym uruchomieniem.
Media odczyt zwrócony 403Sprawdź uprawnienia do odczytu pamięci masowej lub link do aplikacji. Klucz FlashData API nie odblokowuje S3.
Podpisany wynik JSON wygasłPrzeczytaj ponownie punkt końcowy wyniku pracy, podczas gdy wynik jest zachowany. Magazynowane media podążają za cyklem życia twojego wiadra.
CLI · sprawdź zapisany bieg
flashdata runs show download-001 --json

Podaj swojemu agentowi kryteria produkcji i dostawy

Zadania agenta · dostarczyć wideo, przeznaczenia i budżetu
Użyj mojego zapisanego dostępu właściciela i skonfigurowanego prywatnego przechowywania.
Przeczytaj download-request.json dla wideo i wyjścia; nie zmieniaj ich po cichu.
Sprawdź ceny pobierania i dostępne kredyty z zatwierdzonym budżetem zadań.
Prześlij raz, zapisz run/job ID, a następnie przeczytaj to zadanie do końca.
Zachowaj zapis dostawy. Weryfikuje rozmiar zapisanego obiektu i MD5 przed jego przetwarzaniem.
Zgłoś lokalizację obiektu, wybrany format, wynik weryfikacji i rzeczywiste wykorzystanie.
Jeśli złożenie jest niepewne, sprawdź zapisaną pracę; nie tworzyć dostępu zastępczego lub innego pobierania.
Zachowaj prywatne dokumenty. Udostępnianie mediów tylko za pomocą skonfigurowanych kontroli dostępu aplikacji.