# แนวทางใช้ YouTube Download

เลือกรายการสื่อที่ถูกต้อง, ควบคุมสิ่งที่คุณดาวน์โหลด และเปลี่ยนทาสก์ที่เสร็จสมบูรณ์ให้เป็นแฟ้มส่วนตัวที่ใช้ได้

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/youtube-download-guide
Recorder: 2026-11-04 โดย FlashData

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

## เริ่ม ด้วย สิ่ง ที่ คุณ ต้อง ทํา

| เป้าหมายของคุณ | ใช้ |
| --- | --- |
| ปรับเนื้อหาที่พูดหรือสร้างดัชนีข้อความ | อ่านสําเนาที่มีอยู่ก่อน ดาวน์โหลดเสียงเฉพาะเมื่องานของคุณต้องการเสียงเอง เช่น การแยกคําต่อข้อความเป็นขั้นตอน |
| ประมวลผลคําพูดหรือเสียง | การแสดงผลเฉพาะเสียง หลีก เลี่ยง การ ติด ตาม ร่อง ทาง วิดีโอ ที่ โปรแกรม ของ คุณ ไม่ ใช้. |
| แสดงส่วนตัดต่อแบบสั้น | ตั้งค่า start_at ถึง end_at. ตรวจสอบว่าทั้งคู่อยู่ในระยะเวลาของวีดีโอต้นฉบับ |
| เล่นหรือประมวลผลวิดีโอ | MP4 ด้วยเสียงและหมวกความละเอียดเหมาะกับโปรแกรมของคุณ; ตัวอย่างการใช้งาน <=720. |

- [ผลรวมจากคําบรรยายภาพ](https://flashdata.dev/th/docs/guides/youtube-summary/reference.md)
- [เลือกข้อมูลกํากับภาพแบบวิดีโอ](https://flashdata.dev/th/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-คลิปที่สอง

เพลงที่ตัดมาจาก MP4 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/th/docs/sources/youtube_download/reference.md#parameters)

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

## ตรวจสอบสิทธิ์เจ้าของและค่านําหน้าแบบโดยกําหนด

ใช้ Bash ถึง jq# บวกกับเซฟ # CLI โพรไฟล์สี FLASHDATA_API_KEY สําหรับ HTTP. กุญแจต้องขออนุญาต youtube_download การดาวน์โหลดต้องการสิทธิ์ของเจ้าของ; การเข้าใช้ข้อมูลชั่วคราวไม่ได้รวมเอาไว้ด้วย CLI ตัวอย่างต่าง ๆ โดยใช้โพรไฟล์ปริยายของคุณ; เพิ่ม --profile เรียกชื่อทุกคําสั่งถ้าชื่อของคุณ

| การตัดสินใจ | ใช้มันแบบนี้ |
| --- | --- |
| ค่าใช้จ่ายโดยประมาณ | ใช้การตอบกลับ creditsPerTb ถึง bytesPerUnit ด้วยผลที่ประมาณได้ของคุณ การลงรหัสไม่ใช่ค่าใช้จ่ายคงที่ต่อการร้องขอ |
| ขอบเขตการควบคุม | เลือกเสียง, คลิปหรือหมวกความละเอียดก่อนการส่งข้อมูล ใช้ กฎ ข้อ บังคับ ใน การ ทํา งาน. |
| บันทึกค่าใช้จ่ายจริง | อ่านการใช้งานจากการส่งเสร็จสมบูรณ์ การบริการอาจถือเครดิตก่อนที่การอัปโหลดจะยุติการทํางาน; ดุลยภาพปัจจุบันไม่ใช่หมวกจ่ายงานต่องาน |

### เช็คข้อมูลอิสระ CLI

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

- [ตั้งค่ากุญแจเจ้าของ](https://flashdata.dev/th/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP สมดุลและสัดส่วน](https://flashdata.dev/th/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 แฟ้มส่วนตัวของ eH

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

- [Windows สิทธิ์ที่อนุญาตของแฟ้ม](https://flashdata.dev/th/docs/guides/cli-automation/reference.md#storage)
- [ผู้จัดเก็บอื่น ๆ](https://flashdata.dev/th/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/th/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

#### ดึงการส่งมอบ 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/th/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 จากการร้องขอที่เลือก และตรวจสอบขนาดและ checksum โดยไม่ต้องเขียนแฟ้มภายในระบบที่มีอยู่มากเกินไป

#### 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/th/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/th/docs/guides/agent-recovery/reference.md)
- [ข้อผิดพลาดและรหัสสถานะ](https://flashdata.dev/th/docs/errors/reference.md)
- [งานที่ทำซ้ำตามกำหนด](https://flashdata.dev/th/docs/guides/recurring-tasks/reference.md)

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

## ให้ตัวแทนของคุณแสดงและส่ง

### Aagent job play effect วีดีโอ, จุดหมายปลายทาง และงบประมาณ

```text
ใช้ความเป็นเจ้าของของฉันที่บันทึกไว้ และปรับแต่งการจัดเก็บส่วนบุคคล
อ่าน download-request.json สําหรับวิดีโอและการแสดงผล; อย่าเปลี่ยนพวกเขาเงียบ
Check downloads prizes and access ที่มีอยู่ต่องบประมาณงานที่อนุญาต
ยอมแพ้ครั้งเดียว, บันทึก run/job IDอ่านงานนั้นให้เสร็จ
บันทึกการส่งมอบ ตรวจสอบขนาดของวัตถุที่เก็บไว้ MD5 ก่อนที่จะประมวลผลมัน
รายงานตําแหน่งวัตถุ, รูปแบบการเลือก, ผลการตรวจสอบ และการใช้งานจริง
หากการส่งข้อมูลไม่แน่ใจ ให้ตรวจสอบการทํางานที่ถูกบันทึกไว้ อย่าสร้างการเข้าถึงใหม่ หรือการดาวน์โหลดอื่น
เก็บบันทึกเอกสารส่วนตัวไว้ ใช้สื่อร่วมกันผ่านทางการควบคุมการเข้าใช้ของโปรแกรมเท่านั้น
```

- [สร้างท่อส่งข้อมูลของโปรแกรม](https://flashdata.dev/th/docs/guides/media-delivery-pipeline/reference.md)
