본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

가이드

YouTube Download 모범 사례

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

이 페이지의 내용

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

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

당신이 원하는 출력을 저장

하나의 탭을 선택하고 download-request.json로 전체 요청을 저장하십시오. 소스에 video_id 변경. 아래 제출 명령은이 파일을 읽을 수 있으므로 오디오 또는 클립이 실제 요청을 변경합니다.

오디오와 완벽한 비디오, 720p에서 캡핑.

download-request.json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}

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

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

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

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

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

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

한 번 저장된 요청 제출

파일을 모두 저장 한 후 하나의 탭을 실행합니다. 명령은 stdin를 통해 storage.json를 주사하고 download-submission.json를 저장합니다. 이 영수증을 지키십시오. CLI를 사용하면 재try에 동일한 실행 ID를 유지합니다. 의도적인 새로운 출력에만 새로운 ID를 사용하십시오. HTTP 제출은 CLI의 로컬 실행 저널을 사용하지 않습니다.

선택된 출력 제출
(
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
)

CLI로 먼저 유효

ok: true 및 data.dryRun: true를 기대합니다. 이 체크 입력 및 FlashData 액세스는 작업을 제출하지 않고; 업로드 자격 증명을 버킷에 쓸 수 없습니다.

무료 드라이 런
(
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
)

현재 업무에 대한 기대

제출 영수증은 미디어 파일이 아닙니다. CLI 대기; HTTP 명령은 한 번 상태를 읽습니다. 완료 또는 실패할 때까지 마감일 내에 읽음을 반복합니다. 로컬 타임아웃은 서버 작업을 취소하지 않습니다.

저장된 일을 기다립니다
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

배달 기록을 읽고, 다음 미디어에 액세스

완료 후, 제출하는 것과 동일한 경로를 사용하여 delivery.json를 검색합니다. URL는 JSON를 검색합니다. 결과[0].file_url는 저장 매체를 식별합니다. 개인 file_url는 귀하의 응용 프로그램에 의해 발행 된 스토리지 읽힌 ID 또는 링크를 필요로합니다.

저장 delivery.json
(
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
)

자주 묻는 질문

1개의 파일 위치, 긍정적인 file_size, MD5 및 사용법을 예상하십시오. 전달된 객체에 file_size 기록; downloaded_bytes는 전송 필드이며, 최종 사용료는 대체되지 않습니다.

delivery.json 검사
(
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
)

S3의 로컬 복사본을 검증

OBJECT_KEY를 file_url에서 전달된 미디어 키로 설정하여 접두사를 포함한. 읽힌 접근, jq 및 OpenSSL를 가진 AWS CLI를 사용하십시오. 이 저장 media.mp4 또는 media.mp3 당신의 선택된 요구에 따라 그리고 기존의 로컬 파일을 과잉하지 않고 그것의 크기와 체크섬을 확인합니다.

S3 읽기 · 새로운 FlashData 쿼리
(
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'
)

실패한 단계에서 복구

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

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

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