# Najlepsze praktyki YouTube Download

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

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/youtube-download-guide
Przegląd: 2026-11-04 przez FlashData

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

## Zacznij od tego, czego potrzebuje Twoje zadanie

| Twój cel | Stosowanie |
| --- | --- |
| Podsumowanie treści mówionej lub utworzenie indeksu tekstowego | Najpierw 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 audio | Wyjście tylko dla audio. Unikaj posiadania ścieżki wideo, której nie używa aplikacja. |
| Pokaż krótki fragment | Ustaw start_at i end_at. Sprawdź, czy oba są w czasie trwania nagrania. |
| Odtwarzanie lub przetwarzanie wideo | MP4 z dźwiękiem i kapslem rozdzielczości dopasowanym do Twojej aplikacji; przykład wykorzystuje <=720. |

- [Podsumowania z podpisach](https://flashdata.dev/pl/docs/guides/youtube-summary/reference.md)
- [Sprawdź metadane wideo](https://flashdata.dev/pl/docs/guides/youtube-data-guide/reference.md#metadata)

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

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

### MP4 / 720p

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

#### download-request.json

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


### MP3

Plik audio do słuchania lub dalszego przetwarzania dźwięku.

#### download-request.json

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


### 5- drugi klip

Fragment MP4 z 00:00:05 do 00:00:10. Użyj razy, które pasują do wybranego filmu.

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


- [Wszystkie opcje formatu](https://flashdata.dev/pl/docs/sources/youtube_download/reference.md#parameters)

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

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

| Decyzja | Zastosuj to w ten sposób |
| --- | --- |
| Szacunkowy koszt | Użyj zwróconego creditsPerTb i bytesPerUnit z szacowanymi bajtami wyjściowymi. Cena pobierana nie jest stałą opłatą za każde żądanie. |
| Zakres kontroli | Przed 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łaty | Przeczytaj 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

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

- [Konfiguracja klucza właściciela](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md)
- [Saldo i ceny HTTP](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md#balance)

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

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

| Kredytowe | Cel |
| --- | --- |
| Klawisz FlashData | Prześlij pobranie i przeczytaj jego zadanie i dostawy JSON. |
| Przechowywanie wysyłania uwierzytelniającego | Napisz media do zamierzonego wiadra i przedrostka. |
| Identyfikacja wniosku o przechowywanie | Odczytaj obiekt prywatny lub wydaj dostęp do autoryzowanego użytkownika. |

### 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 · plik prywatny

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

- [Uprawnienia do pliku Windows](https://flashdata.dev/pl/docs/guides/cli-automation/reference.md#storage)
- [Inne podmioty świadczące usługi przechowywania danych](https://flashdata.dev/pl/docs/sources/youtube_download/reference.md#storage)

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

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

### CLI

#### Prześlij wybrane wyjście

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

#### Prześlij wybrane wyjście

```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 umowa na żądanie](https://flashdata.dev/pl/docs/reference/realtime-and-async/reference.md#async)

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

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

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

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

#### CLI

##### Czekaj na uratowaną pracę

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


#### HTTP / cURL

##### Przeczytaj status raz

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

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

### CLI

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

#### Dostawa do pobrania JSON · zachować klucz API poza żądaniami przechowywania

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

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

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

- [Weryfikacja i obsługa obiektu prywatnego](https://flashdata.dev/pl/docs/guides/media-delivery-pipeline/reference.md#verify)

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

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

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

- [Retencja wyników i przechowywanie nośników](https://flashdata.dev/pl/docs/guides/save-results/reference.md#media)

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

## Odzyskanie ze sceny, która zawiodła

| Co się stało? | Następna akcja |
| --- | --- |
| Złożenie w czasie bez potwierdzonej pracy ID | Sprawdź zapisany bieg CLI lub historię żądania. Zachowaj oryginalne dane wejściowe i nie poddawaj się automatycznie. |
| Zaakceptowana praca; czas oczekiwania | Odczyt 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 403 | Sprawdź 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

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

- [Decyzje w sprawie odzyskania pomocy](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)
- [Błędy i kody statusu](https://flashdata.dev/pl/docs/errors/reference.md)
- [Zadania cykliczne](https://flashdata.dev/pl/docs/guides/recurring-tasks/reference.md)

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

## Podaj swojemu agentowi kryteria produkcji i dostawy

### Zadania agenta · dostarczyć wideo, przeznaczenia i budżetu

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

- [Zbuduj rurociąg aplikacji](https://flashdata.dev/pl/docs/guides/media-delivery-pipeline/reference.md)
