# YouTube Download 모범 사례

올바른 미디어 출력을 선택, 다운로드하는 것을 제어, 그리고 완료 작업을 usable 개인 파일로 전환.

Canonical 참고: https://flashdata.dev/ko/docs/guides/youtube-download-guide
검토: 2026-11-04 FlashData

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

## 작업이 필요한 것을 시작하십시오

| 당신의 목표 | 제품 정보 |
| --- | --- |
| 말한 내용을 요약하거나 텍스트 인덱스를 구축 | 기존의 성적표를 먼저 읽으십시오. 작업 흐름이 오디오 자체를 필요로 할 때만 오디오를 다운로드하십시오. |
| 과정 연설 또는 오디오 | 오디오 전용 출력. 비디오 트랙을 수행하지 마십시오. 응용 프로그램은 사용하지 않습니다. |
| 짧은 발췌보기 | start_at 및 end_at를 설정합니다. 둘 다 소스 비디오의 내구를 확인 합니다. |
| 놀이 또는 공정 비디오 | 오디오 및 해상도 캡이 응용 프로그램에 적합했습니다. 예를 들어 <=720를 사용합니다. |

- [captions에서 요약](https://flashdata.dev/ko/docs/guides/youtube-summary/reference.md)
- [Inspect 비디오 메타데이터](https://flashdata.dev/ko/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-second 클립

00:00:05에서 00:00:10에 MP4 발췌. 선택한 비디오와 일치하는 시간을 사용합니다.

#### 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/ko/docs/sources/youtube_download/reference.md#parameters)

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

## 소유자 액세스 및 바이트 기반 가격 확인

Bash 및 jq를 사용하여 CLI 프로파일 또는 FLASHDATA_API_KEY를 HTTP에 저장했습니다. 키는 youtube_download 권한이 필요합니다. 다운로드는 소유자 액세스가 필요합니다. 임시 체험 액세스는 포함되지 않습니다. CLI 예제는 기본 프로파일을 사용합니다. --profile 이름을 각 명령에 추가하면 됩니다.

| 팟캐스트 | 이 방법을 적용 |
| --- | --- |
| 견적 비용 | 반환된 creditsPerTb 및 bytesPerUnit를 사용하여 견적된 출력 바이트를 제공합니다. 다운로드 가격은 요청에 따라 고정 수수료가 없습니다. |
| 제어 범위 | 오디오, 클립 또는 해상도 캡을 제출하기 전에 선택합니다. 귀하의 응용 프로그램에서 직업 및 지출 규칙을 적용하십시오. |
| 실제 충전 | 완료된 납품에서 사용법을 읽으십시오. 입학은 업로드 결산 전에 신용을 보유 할 수 있습니다. 현재 균형은 per-job 지출 캡이 아닙니다. |

### 무료 체크인 · CLI

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

- [소유권 키 설정](https://flashdata.dev/ko/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP 균형과 가격](https://flashdata.dev/ko/docs/guides/credits-and-billing/reference.md#balance)

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

## 각 출력에 대한 개인 목적지를 사용합니다

storage.json를 사용하여 실제 대상 값으로 저장합니다. 외부 소스 제어를 유지하십시오. 각 video/output 버전을 위한 명백한 object_prefix를 사용하십시오; 다른 산출을 위한 접두사를 재사용하는 것은 신청 기록이 더 단단한 것을 reconcile 만듭니다.

| 주요 특징 | 제품정보 |
| --- | --- |
| FlashData 열쇠 | 다운로드를 제출하고 작업 및 배달 JSON를 읽으십시오. |
| 저장 업로드 credential | 글쓰기 미디어는 의도한 물통과 접두사에. |
| 신청 저장 ID | 개인 객체를 읽거나 권한이 있는 사용자에 액세스할 수 있습니다. |

### 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/ko/docs/guides/cli-automation/reference.md#storage)
- [기타 스토리지 제공 업체](https://flashdata.dev/ko/docs/sources/youtube_download/reference.md#storage)

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

## 한 번 저장된 요청 제출

파일을 모두 저장 한 후 하나의 탭을 실행합니다. 명령은 stdin를 통해 storage.json를 주사하고 download-submission.json를 저장합니다. 이 영수증을 지키십시오. CLI를 사용하면 재try에 동일한 실행 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/ko/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를 검색합니다. 결과[0].file_url는 저장 매체를 식별합니다. 개인 file_url는 귀하의 응용 프로그램에 의해 발행 된 스토리지 읽힌 ID 또는 링크를 필요로합니다.

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

### 자주 묻는 질문

1개의 파일 위치, 긍정적인 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/ko/docs/guides/media-delivery-pipeline/reference.md#verify)

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

### S3의 로컬 복사본을 검증

OBJECT_KEY를 file_url에서 전달된 미디어 키로 설정하여 접두사를 포함한. 읽힌 접근, jq 및 OpenSSL를 가진 AWS CLI를 사용하십시오. 이 저장 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/ko/docs/guides/save-results/reference.md#media)

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

## 실패한 단계에서 복구

| 어떤 일이 있었는지 | 다음 작업 |
| --- | --- |
| 제출은 확인된 직업 ID로 밖으로 중단했습니다 | 저장된 CLI 실행 또는 요청 내역을 검사합니다. 원본 입력을 유지하고 자동으로 다시 제출하지 마십시오. |
| 근무 가능; 대기 시간 | 읽거나 같은 일을 복구하십시오. 계속 기다리는 다른 다운로드를 만들지 마십시오. |
| 업로드 실패 | 작업 오류를 읽고 목적지 설정을 수정하거나 의도적으로 재발하기 전에 액세스 작성하십시오. |
| 미디어는 403를 반환 | 저장을 읽는 권한 또는 신청 조직 링크를 확인하십시오. FlashData API 키는 S3를 잠금 해제하지 않습니다. |
| 표시된 결과 JSON 만료됨 | 결과가 유지되는 동안 작업 결과 종료점을 다시 읽으십시오. 저장된 매체는 당신의 물통의 lifecycle를 따릅니다. |

### CLI · 저장된 실행을 검사

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

- [복구 결정](https://flashdata.dev/ko/docs/guides/agent-recovery/reference.md)
- [오류와 상태 코드](https://flashdata.dev/ko/docs/errors/reference.md)
- [정기 작업](https://flashdata.dev/ko/docs/guides/recurring-tasks/reference.md)

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

## 당신의 대리인에게 산출과 납품 기준을 주십시오

### 에이전트 작업 · 비디오, 목적지 및 예산 공급

```text
저장 된 소유자 액세스 및 개인 저장을 구성합니다.
비디오 및 출력에 대한 download-request.json를 읽으십시오. 조용히 변경하지 마십시오.
다운로드 가격 및 승인 된 작업 예산에 대한 사용 가능한 크레딧을 확인하십시오.
한 번 제출하면 run/job ID를 저장하고 완료 작업을 읽습니다.
배송 기록 저장. 저장 된 객체의 크기와 MD5를 검증하기 전에.
오브젝트 위치를 보고, 선택한 형식, 검증 결과 및 실제 사용.
제출이 불확실한 경우, 저장된 작업을 검사; 교체 액세스 또는 다른 다운로드를 만들지 마십시오.
저장 credentials 개인을 지키십시오. Application의 설정된 액세스 제어를 통해 미디어를 공유합니다.
```

- [Application 파이프라인 구축](https://flashdata.dev/ko/docs/guides/media-delivery-pipeline/reference.md)
