# YouTube Download кращих практик

Виберіть правильний вихід медіа, контроль за тим, що ви завантажуєте, і ввімкніть готову роботу в зручний приватний файл.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/youtube-download-guide
Переглянуто: 2026-11-04 від FlashData

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

## Почати з чого потрібно завдання

| Ваше завдання | Зареєструватися |
| --- | --- |
| Summarize сповіщав зміст або побудувати текстовий індекс | Переглянути наявний трафарет першого. Завантажити аудіо тільки тоді, коли ваш робочий процес необхідний сам аудіо, наприклад, окремий мовний крок. |
| Процес мовлення або аудіо | Аудіо-тільки вихідний. Уникайте перенесення відео доріжки, який не використовується. |
| Показати короткий різак | Комплект start_at і end_at. Перевірити, що обидва є в межах продовження відео. |
| Грати або процес відео | MP4 з аудіо та роздільною здатністю, яка підходить до вашої програми; приклад використовує <=720. |

- [Сумпери з прикметів](https://flashdata.dev/uk/docs/guides/youtube-summary/reference.md)
- [Перегляд метаданих відео](https://flashdata.dev/uk/docs/guides/youtube-data-guide/reference.md#metadata)

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

## Збережіть вихід, який ви хочете

Виберіть одну вкладку і зберегти весь запит як download-request.json. Зміна video_id для вашого джерела. Накази про подання нижче, ознайомтеся з цим файлом, щоб вибрати аудіо або кліп зміни фактичного запиту.

### MP4 / 720p

Повне відео з аудіо, нахоплений на 720p.

#### download-request.json

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


### MP3

Аудіофайл для прослуховування або подальшої обробки аудіо.

#### download-request.json

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


### 5-секундний кліп

Мп4 з 00:00:05 до 00:00:10. Використовуйте час, які відповідають вибраному відео.

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


- [Всі варіанти форматів](https://flashdata.dev/uk/docs/sources/youtube_download/reference.md#parameters)

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

## Перевірити доступ власника та байтове ціноутворення

Використовуйте Bash і jq, а також збережений профіль CLI або FLASHDATA_API_KEY для HTTP. Ключ має містити дозвіл youtube_download. Завантаження потребує доступу власника; тимчасовий пробний доступ його не включає. Приклади CLI використовують профіль за замовчуванням; для іменованого профілю додайте --profile NAME до кожної команди.

| Пожертвувати | Застосувати цей спосіб |
| --- | --- |
| Орієнтовна вартість | Використовуйте повернутий creditsPerTb і bytesPerUnit з вашим розрахунковим вихідним байтами. За запитом не надається додаткове ціноутворення. |
| Область управління | Виберіть аудіо, кліп або ковпачок для вирішення перед подачею. Застосувати правила оплати праці в додатку. |
| Запис фактичного заряду | Прочитати використання з готової доставки. Прийняття може утримувати кредити до завантажень; поточний баланс не завантажує ковпачок. |

### Безкоштовні перевірки · CLI

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

- [Налаштування ключа власника](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP баланс і ціноутворення](https://flashdata.dev/uk/docs/guides/credits-and-billing/reference.md#balance)

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

## Використовуйте приватний пункт для кожного виходу

Заощаджуйте storage.json в приватному порядку з вашими значеннями призначення. Зберігати його за межі джерела управління. Використовуйте відмінну версію object_prefix для кожної версії video/output; багаторазовий префікс для різних виводів робить записи додатків важче, щоб зекономити.

| Поведінка | Мета |
| --- | --- |
| FlashData ключ | Завантажте та прочитайте свою роботу та доставку JSON. |
| Зберігання завантажити облікові дані | Написати медіа на призначене відро і префікс. |
| ідентичність зберігання додатків | Читання приватного об’єкта або виходу з авторизованого користувача. |

### 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 · приватний файл

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

- [Windows дозволи на файл](https://flashdata.dev/uk/docs/guides/cli-automation/reference.md#storage)
- [Інші постачальники зберігання](https://flashdata.dev/uk/docs/sources/youtube_download/reference.md#storage)

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

## Подати збережений запит один раз

Запустіть одну вкладку після збереження обох файлів. Команда вводить storage.json через stdin і зберігає download-submission.json. Зберігайте цей чек. За допомогою CLI зберігають однаковий хід ID для трейдингу; використовують новий ID тільки для навмисного нового виходу. HTTP Подання не використовують CLI- локальний журнал запуску.

### CLI

#### Відправити вибраний вихід

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

#### Відправити вибраний вихід

```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 договір запиту](https://flashdata.dev/uk/docs/reference/realtime-and-async/reference.md#async)

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

### Важкий перший з CLI

Витратити ok: true і data.dryRun: true. Це перевіряє вхід та доступ до FlashData без подання завдання; це не доводить завантажувальні дані можуть написатися на ваш відро.

#### Безкоштовна стійка для сухого

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

### Очікується існуючої роботи

При отриманні інформації не є медіафайлом. CLI очікується; команда HTTP прочитає статус раз. Повторити читання в термін до завершення або не вдалося. У локальному режимі не скасовує роботу сервера.

#### CLI

##### Очікується, що збережена робота

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


#### HTTP / cURL

##### Читати статус раз

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

## Читати запис про доставку, потім доступ до ЗМІ

Після завершення, отримайте delivery.json за допомогою того ж шляху, який ви використовували для подачі. У зареєстрованому результаті URL отримує JSON; results[0].file_url визначає медіа у вашому складі. Приватний file_url потребує вашого читання читальної ідентичності або посилання, видане вашим додатком.

### CLI

#### Зберегти 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

#### Доставка Fetch JSON · зберегти API ключ від запитів на зберігання

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

### Перевірити те, що було доставлено

Визначити одне місце розташування файлів, позитивний file_size, MD5 і використання. Запис file_size для поставленого об'єкта; downloaded_bytes - це поле передачі, не заміна для кінцевого заряду у використанні.

#### Огляд 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
)
```

- [Перевірити і обслуговувати приватний об'єкт](https://flashdata.dev/uk/docs/guides/media-delivery-pipeline/reference.md#verify)

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

### Перевірити локальну копію від S3

Налаштуйте OBJECT_KEY на доставку медіа ключ від file_url, включаючи його префікс. Використовуйте AWS CLI з доступом для читання, jq та OpenSSL. Це зберігає media.mp4 або media.mp3 відповідно до обраного запиту та перевіряє його розмір і контроль без перезапису існуючого локального файлу.

#### S3 читати · немає нового запиту 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'
)
```

- [Затримка результатів та збережені медіа](https://flashdata.dev/uk/docs/guides/save-results/reference.md#media)

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

## Відновити від етапу, що не вдалося

| Що відбулося | Попередня дія |
| --- | --- |
| Запущено термін дії без підтвердженої роботи ID | Ознайомтеся з збереженою CLI та історією запиту. Зареєструватися і не вводити в автоматичне введення. |
| Робота прийнята; час очікування | Читання або відновлення однієї роботи. Не створювати ще одну завантаження для продовження очікування. |
| Не вдалося завантажити | Прочитайте помилки роботи та зафіксуйте налаштування призначення або напишіть доступ до навмисно переробляючи. |
| Медіа читати повернуто 403 | Перевірити наявність дозволу на зберігання або застосувати посилання. FlashData API ключ не розблокує S3. |
| Зареєстрований результат JSON розірваний | Прочитайте кінцеву точку роботи знову, поки результат не зберігався. Зберігайте медіа, дивитесь на життєвий цикл відра. |

### CLI · огляд збереженого запуску

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

- [Рішення для відновлення](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)
- [Помилки й коди стану](https://flashdata.dev/uk/docs/errors/reference.md)
- [Регулярні завдання](https://flashdata.dev/uk/docs/guides/recurring-tasks/reference.md)

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

## Подаруйте свій агент за критеріями виведення та доставки

### Завдання агента · постачання відео, призначення та бюджету

```text
Використовуйте свій збережений доступ власника та настроюється приватний накопичувач.
Читання download-request.json для відео та виходу; не змінюйте їх мовчно.
Перевірити завантаження цін і наявних кредитів на затверджений бюджет завдань.
Після того, як зберегти run/job ID, потім читати цю роботу для завершення.
Заощаджуйте запис доставки. Перевірити розмір збереженого об'єкта і MD5 перед обробкою.
Повідомляти про розташування об'єкта, вибраний формат, результат перевірки та фактичне використання.
Якщо подання не існує, перевірте збережену роботу; не створюйте доступ до заміни або інший завантажити.
Зберігайте облікові дані, приватні. Поділитися носіями тільки через налаштування доступу програми.
```

- [Побудова трубопроводу застосування](https://flashdata.dev/uk/docs/guides/media-delivery-pipeline/reference.md)
