# YouTube Download Thực hành tốt nhất

Chọn đầu ra đúng phương tiện, điều khiển những gì bạn tải về, và biến một công việc hoàn tất thành một tập tin tư nhân có thể sử dụng.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/youtube-download-guide
Xem lại: 2026-11-04 by FlashData

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

## Hãy bắt đầu với những gì bạn cần

| Mục tiêu của bạn | Dùng |
| --- | --- |
| Tóm tắt nội dung đã nói hoặc xây dựng chỉ mục văn bản | Trước tiên, hãy đọc một bản sao đã có. Chỉ tải về âm thanh khi bạn cần âm thanh, như bước nói chuyện để văn bản. |
| Tiến trình phát âm hoặc âm thanh | Đầu ra chỉ âm thanh. Tránh mang theo video theo dõi ứng dụng của bạn không dùng. |
| Hiển thị đoạn ngắn | Đặt start_at và end_at. Kiểm tra rằng cả hai đều nằm trong khoảng thời gian của video nguồn. |
| Chơi hay xử lý video | MP4 với âm thanh và một nắp giải quyết phù hợp với ứng dụng của bạn; ví dụ này dùng <=720. |

- [Tóm tắt từ phụ đề](https://flashdata.dev/vi/docs/guides/youtube-summary/reference.md)
- [Kiểm tra siêu dữ liệu phim](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md#metadata)

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

## Lưu kết xuất mà bạn muốn

Chọn một tab và lưu toàn bộ yêu cầu của nó như là download-request.json. Thay đổi video_id cho nguồn của bạn. Lệnh phục tùng bên dưới đọc tập tin này, vì vậy chọn âm thanh hay clip thay đổi yêu cầu thực sự.

### MP4 / 720p

Một đoạn video đầy đủ với âm thanh, bị bao phủ tại 720p.

#### download-request.json

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


### MP3

Một tập tin âm thanh để lắng nghe hoặc xử lý âm thanh thêm nữa.

#### download-request.json

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


### 5- clip thứ hai

Một trích đoạn MP4 từ 00:00:05 phải 00:00:10. Dùng thời gian khớp với video đã chọn.

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


- [Mọi tùy chọn định dạng](https://flashdata.dev/vi/docs/sources/youtube_download/reference.md#parameters)

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

## Kiểm tra quyền truy cập và giá trị phụ thuộcte

Dùng Bash và jq, cộng với tiết kiệm CLI hồ sơ hay FLASHDATA_API_KEY Vì HTTP. Chìa khóa cần thiết youtube_download Cho phép. Tải về cần thiết quyền người sở hữu; quyền truy cập thử nghiệm tạm thời không bao gồm nó. CLI Ví dụ dùng hồ sơ mặc định; thêm --profile NAME tới mọi lệnh nếu tên của anh được đặt.

| Quyết định | Áp dụng theo cách này |
| --- | --- |
| Giá dự đoán | Dùng cái này đi creditsPerTb và bytesPerUnit với các byte ước tính đầu ra của bạn. Việc tải về không phải là một tính phí cố định cho mỗi yêu cầu. |
| Phạm vi điều khiển | Chọn âm thanh, clip hoặc nắp giải quyết trước khi nộp. Áp dụng số liệu công việc và chi tiêu các quy tắc trong đơn xin việc của bạn. |
| Ghi lại chi phí thực sự | Đọc từ lần giao xong. Việc nhập viện có thể giữ được tín dụng trước khi việc tải lên được giải quyết; sự số dư hiện tại không phải là một cái nắp chi tiêu cho một công việc. |

### Kiểm tra miễn phí # CLI

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

- [Thiết lập phím của người sở hữu](https://flashdata.dev/vi/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP số dư và giá trị](https://flashdata.dev/vi/docs/guides/credits-and-billing/reference.md#balance)

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

## Dùng điểm đến riêng cho mỗi kết xuất

Lưu storage.json Riêng tư với giá trị đích thực của bạn. Giữ nó bên ngoài kiểm soát nguồn. Sử dụng một khác biệt object_prefix cho mỗi video/output Phiên bản; tái sử dụng một tiền tố cho các kết quả khác nhau làm cho hồ sơ ứng dụng khó hòa giải hơn.

| Nhận diện | Mục đích |
| --- | --- |
| Phím FlashData | Gửi tải xuống và đọc công việc và giao hàng của nó JSON. |
| Name | Viết truyền thông tới xô và tiền tố đã định. |
| Nhận diện kho lưu ứng dụng | Đọc mục riêng hoặc quyền truy cập vào người dùng có thẩm quyền. |

### 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 Tập tin · cá nhân

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

- [Windows Quyền tập tin](https://flashdata.dev/vi/docs/guides/cli-automation/reference.md#storage)
- [Các nhà cung cấp lưu trữ khác](https://flashdata.dev/vi/docs/sources/youtube_download/reference.md#storage)

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

## Gửi yêu cầu cứu hộ một lần

Chạy một tab sau khi lưu cả hai tập tin. Name storage.json đi qua stdin và lưu download-submission.json. Giữ cái hóa đơn này. Với CLIGiữ nguyên vị trí đó ID Cho một lần thử lại; sử dụng một điều mới ID Chỉ cho đầu ra có chủ đích mới. HTTP Phục tùng không dùng CLINhật ký điều hành địa phương.

### CLI

#### Gởi kết xuất đã chọn

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

#### Gởi kết xuất đã chọn

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


- [Hợp đồng yêu cầu Async](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#async)

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

### Kiểm tra trước với CLI

Mong đợi ok: true và data.dryRun: true. Kiểm tra đầu vào và FlashData Việc truy cập mà không gửi một việc làm; nó không chứng minh giấy ủy nhiệm tải lên có thể viết cho xô của bạn.

#### Chạy tự do

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

### Đợi công việc đã có

Hóa đơn không phải là hồ sơ truyền thông. CLI chờ đợi; các HTTP lệnh đọc tình trạng một lần. Lặp lại đoạn đọc trong thời hạn cuối cùng cho đến khi hoàn tất hoặc bị lỗi. Thời hạn cục bộ không hủy bỏ công việc máy phục vụ.

#### CLI

##### Chờ công việc đã được cứu

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


#### HTTP / cURL

##### Đọc trạng thái một lần

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

## Đọc hồ sơ giao hàng, rồi truy cập vào các phương tiện truyền thông

Sau khi hoàn thành, lấy lại delivery.json bằng cùng một con đường mà anh đã từng phục vụ. Kết quả đã được ký. URL lấy JSON; results[0].file_url Xác định phương tiện truyền thông trong kho của anh. Riêng tư file_url Cần phải có giấy tờ đọc hoặc liên kết được đưa ra bởi đơn xin việc của bạn.

### CLI

#### Lưu 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

#### Lấy JSON giao nhận · không gửi khóa API trong yêu cầu đến kho lưu trữ

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

### Kiểm tra xem cái gì đã được chuyển đến

Mong đợi một vị trí tập tin, một kết quả dương file_size, a MD5 và sử dụng. Thu file_size cho đối tượng được giao; downloaded_bytes là một trường chuyển giao, không phải một sự thay thế cho lần nạp cuối cùng.

#### Xem xét 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
)
```

- [Kiểm tra và phục vụ một đối tượng cá nhân](https://flashdata.dev/vi/docs/guides/media-delivery-pipeline/reference.md#verify)

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

### Kiểm tra bản sao của địa phương S3

Đặt OBJECT_KEY đến các phím truyền thông được chuyển từ file_urlKể cả tiền tố. Dùng AWS CLI Với quyền truy cập đọc, jq và OpenSSL. Cái này để dành. media.mp4 hay media.mp3 Tùy theo yêu cầu đã chọn, kiểm tra kích cỡ và tổng kiểm tra mà không viết quá một tập tin cục bộ đã có.

#### S3 đọc và không có gì mới FlashData truy vấn

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

- [Kết quả là nhớ lại và lưu trữ phương tiện](https://flashdata.dev/vi/docs/guides/save-results/reference.md#media)

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

## Phục hồi từ giai đoạn thất bại

| Chuyện gì đã xảy ra | Hành động tiếp theo |
| --- | --- |
| Không xác nhận được việc làm ID | Kiểm tra người được cứu CLI Chạy hoặc yêu cầu lịch sử. Giữ đầu vào ban đầu và không tự động đệ lại. |
| Gióp chấp nhận; chờ đợi hết giờ | Đọc hoặc phục hồi cùng một công việc. Không tạo một bản tải về mới để tiếp tục chờ. |
| Tải lên thất bại | Đọc lỗi công việc và sửa thiết lập đích hoặc ghi truy cập trước khi cố ý thử lại. |
| Đọc phương tiện đã trả lời 403 | Kiểm tra xem quyền hạn đọc hay liên kết đã đóng sẵn của ứng dụng. Hạt FlashData API Phím không mở khóa S3. |
| Đã ký kết quả JSON hết hạn | Hãy đọc lại kết quả của công việc trong khi vẫn còn. Truyền thông lưu trữ đi theo xe đạp cứu hộ của bạn. |

### CLI* kiểm tra các lưu chạy

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

- [Những quyết định hồi phục](https://flashdata.dev/vi/docs/guides/agent-recovery/reference.md)
- [Lỗi và mã trạng thái](https://flashdata.dev/vi/docs/errors/reference.md)
- [Tác vụ định kỳ](https://flashdata.dev/vi/docs/guides/recurring-tasks/reference.md)

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

## Cung cấp cho đại lý của bạn các tiêu chuẩn đầu ra và giao hàng

### Nhiệm vụ tác nhân # cung cấp video, đích và ngân sách

```text
Sử dụng quyền truy cập của tôi và cấu hình kho lưu trữ tư nhân.
Đọc download-request.json cho video và đầu ra; không thay đổi chúng một cách âm thầm.
Kiểm tra giá trị sử dụng và tín dụng có từ ngân sách tác vụ được chấp nhận.
Phục tùng một lần, cứu lấy run/job IDRồi đọc xong công việc đó.
Để dành hồ sơ giao hàng đi. Kiểm tra kích cỡ của đối tượng đã lưu và MD5 Trước khi xử lý nó.
Báo cáo vị trí đối tượng, định dạng, kết quả thẩm tra và sử dụng thực tế.
Nếu sự phục tùng không chắc chắn, thanh tra lưu công việc, đừng tạo cơ hội tiếp cận thay thế hoặc tải về khác.
Giữ hồ sơ lưu trữ kín. Chia sẻ phương tiện chỉ qua điều khiển truy cập đã cấu hình của ứng dụng.
```

- [Xây dựng đường ống dẫn ứng dụng](https://flashdata.dev/vi/docs/guides/media-delivery-pipeline/reference.md)
