İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Kılavuzlar

YouTube Download en iyi uygulamalar

Doğru medya çıktısını seçin, ne indireceğinizi kontrol edin ve tamamlanmış bir işi bir kullanılabilir özel dosyaya dönüştürün.

Bu sayfada

Görevinizin ihtiyaç duyduğu şeyle başlayın

AmacınızKullanım
Konuşma içeriği ya da bir metin indeksi oluşturmakİlk önce mevcut bir transkript okuyun. Sesi sadece iş akışınızın kendi başına ihtiyacı olduğunda, ayrı bir konuşma-rap adım gibi.
Konuşma veya seslendirmeAudio-only çıktı. Uygulamanızı takip eden bir video taşımaktan kaçının kullanmaz.
Kısa bir alıntı gösterinstart_at ve end_at. Her ikisinin de kaynak videonun süresi içinde olduğunu kontrol edin.
Play veya process videoMP4, uygulamanıza uygun bir karar kapla; örneğin <=720. kullanır.

İstediğiniz çıktıyı kurtar

Bir sekme seçin ve tüm isteği download-request.json olarak kurtarın. video_id'u kaynağınız için değiştirin. Aşağıdaki başvuru komutları bu dosyayı okuyun, bu yüzden ses veya bir klip gerçek isteği değiştirir.

Tam bir video, 720p'te kapıldı.

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

Check owner access and byte-based pricing

Bash ve jq, artı bir CLI profili veya FLASHDATA_API_KEY için HTTP. Anahtar youtube_download iznine ihtiyaç duyar. İndirme sahibinin erişimi gerektirir; geçici deneme erişimi buna dahil değildir. CLI örnekleri varsayılan profilinizi kullanır; --profile NAME'i her komuta eklerseniz.

Karar Karar KararıBu şekilde uygulayın
Tahmin maliyeticreditsPerTb ve bytesPerUnit'u tahmin edilen çıktınızla kullanın. İndirme fiyatı talep başına sabit bir ücret değildir.
Kontrol kapsamıSunumdan önce bir klip veya bir karar kapağı seçin. Uygulamanızda iş hesabı uygulayın ve kurallar harcıyorsunuz.
Gerçek şarjı kaydetmekTamamlanan teslimattan kullanım okuyun. Kabul, yükleme yerleşmelerinden önce kredi tutabilir; mevcut denge bir per-job harcama kapağı değildir.
Ücretsiz kontroller · CLI
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json

Her çıktı için özel bir hedef kullanın

storage.json'u özel olarak gerçek varış değerlerinizle kurtarın. Dış kaynak kontrolü dışında tutun. Her video/output versiyonu için ayrı bir object_prefix sürümünü kullanın; farklı çıktılar için bir ön eki tekrar kullanarak uygulama kayıtlarını uzlaştırmayı daha zor hale getirir.

CredentialAmaç
FlashData anahtarıİndirmeyi gönderin ve işini okuyun ve JSON'u teslim edin.
Storageload credentialAmaçlı kovaya ve ekine medya yazın.
Uygulama depolama kimliğiÖzel nesneyi okuyun veya yetkili bir kullanıcıya erişim.
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 · özel dosya
chmod 600 storage.json

Kurtarılan talebi bir kez gönderin

İki dosyayı da kaydettikten sonra sekmelerden birini çalıştırın. Komut storage.json dosyasını stdin üzerinden iletir ve download-submission.json kaydını oluşturur. Bu kaydı saklayın. CLI ile yeniden denerken aynı çalıştırma ID değerini kullanın; yeni ID yalnızca bilinçli olarak yeni çıktı istediğinizde kullanılmalıdır. HTTP gönderimleri CLI uygulamasının yerel çalıştırma günlüğünü kullanmaz.

Seçilen çıktıyı gönderin
(
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
)

İlk önce CLI ile geçerlidir

ok: true ve data.dryRun: true'u bekleyin. Bu giriş ve FlashData bir iş sunmadan erişir; yükleme kimliklerinin sizin kovanıza yazabileceğini kanıtlayamaz.

Ücretsiz kuru koşmak
(
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
)

Mevcut iş için bekleyin

Başvuru makbuzu medya dosyası değildir. CLI bekler; HTTP komut bir kez durumu okur. Tamamlanan veya başarısız olana kadar son zamanlarda okumayı tekrarlayın. Yerel bir süre sunucu işini iptal etmiyor.

Kurtarılan iş için bekleyin
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)

Teslimat kayıtlarını okuyun, sonra medyaya erişim

Tamamlandıktan sonra, delivery.json'yu göndermek için kullandığınız aynı yolu kullanın. İmzalanan sonuç URL, JSON; results[0].file_url, sizin depolamanızda medyayı tanımlar. Özel bir file_url, depolamanızın kimlik veya uygulamanız tarafından yayınlanan bir bağlantıya ihtiyaç duyar.

Save Kaydet 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
)

Ne teslim edildiğini kontrol edin

Bir dosya yerini bekle, olumlu file_size, an MD5 ve kullanımı. Record Record Record file_size teslim edilen nesne için; downloaded_bytes Bir transfer alanı, kullanımdaki son ücret için bir yedek değil.

Inspect 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'dan yerel bir kopyasını doğrulayın

Set Set Set OBJECT_KEY Gönderilen medya anahtarı file_urlAyrıca, ön eki de dahil. AWS CLI'u okuma erişimi ile kullanın, jq ve OpenSSL. Bu, media.mp4 veya media.mp3'u seçtiğiniz isteke göre kurtarır ve mevcut yerel bir dosya yazmadan boyutlarını kontrol eder.

S3 oku · yeni FlashData query
(
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'
)

Başarısız olan sahneden yeniden keşfedin

Ne oldu?Sonraki eylem
Tamamlanmamış iş ID ile test süresikaydedilen CLI koşmak veya tarih talep etmek. Orijinal girişi tutun ve otomatik olarak tekrar göndermeyin.
İş kabul etti; zamanı beklemeAynı işi okuyun ya da kurtarın. Beklemeye devam etmek için başka bir indirme oluşturmayın.
Kod başarısız olduİş hatasını okuyun ve varış yerlerini düzeltin veya kasıtlı olarak yeniden denemeden önce erişim yaz.
Media read döndü 403Kontrol depolama izinleri veya uygulama-konuşuş bağlantısını okuyun. FlashData API anahtarı S3'u açmaz.
Sonuç olarak JSON sona ermiştirİş sonucu endpointi tekrar okuyun, sonuç korunurken. Mağazalı medya, kovanızın yaşam döngüsünü takip eder.
CLI · Kurtarılan koşmayı denetim edin
flashdata runs show download-001 --json

Ajanınıza çıktı ve teslimat kriterlerini verin

Ajan görevi · videoyu, varış ve bütçe tedarik edin
Kurtarılan sahibinin erişimini kullanın ve özel depolama yapılandırın.
Video ve çıktı için download-request.json'u okuyun; onları sessizce değiştirmez.
Onaylanan görev bütçesine karşı fiyat ve mevcut kredileri kontrol edin.
Bir kez gönderin, run/job ID'u kurtar, sonra bu işi tamamlamak için okuyun.
Teslimat kayıtlarını kurtarın. Depolama nesnesinin boyutunu ve MD5'yu işlemeden önce doğrulayın.
object location, seçilmiş format, doğrulama sonucu ve gerçek kullanımı rapor edin.
Eğer teslim belirsiz ise, denetim kurtarılmış iş; yedek erişim veya başka bir indirme yaratmaz.
Depolama bilgilerini özel tut. Medyayı sadece uygulamanın yapılandırılmış erişim kontrolleri aracılığıyla paylaşın.