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

Canonical referans: https://flashdata.dev/tr/docs/guides/youtube-download-guide
İnceleme: 2026-11-04 Tarafından FlashData

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

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

| Amacınız | Kullanı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 seslendirme | Audio-only çıktı. Uygulamanızı takip eden bir video taşımaktan kaçının kullanmaz. |
| Kısa bir alıntı gösterin | start_at ve end_at. Her ikisinin de kaynak videonun süresi içinde olduğunu kontrol edin. |
| Play veya process video | MP4, uygulamanıza uygun bir karar kapla; örneğin <=720. kullanır. |

- [Summaries from captions](https://flashdata.dev/tr/docs/guides/youtube-summary/reference.md)
- [Inspect video metadata](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md#metadata)

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

## İ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.

### MP4 / 720p

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

#### download-request.json

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


### MP3

Daha fazla ses işleme için bir ses dosyası.

#### download-request.json

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


### 5-saniye klip

00:00:05'dan 00:00:10'ye bir MP4 alıntı. Seçilmiş videonuzu eşleşen zamanları kullanı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"
  }
}
```


- [Tüm format seçenekleri](https://flashdata.dev/tr/docs/sources/youtube_download/reference.md#parameters)

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

## 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 maliyeti | creditsPerTb 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ı kaydetmek | Tamamlanan teslimattan kullanım okuyun. Kabul, yükleme yerleşmelerinden önce kredi tutabilir; mevcut denge bir per-job harcama kapağı değildir. |

### Ücretsiz kontroller · CLI

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

- [Sahip anahtar kurulum](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP dengesi ve fiyatlandırma](https://flashdata.dev/tr/docs/guides/credits-and-billing/reference.md#balance)

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

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

| Credential | Amaç |
| --- | --- |
| FlashData anahtarı | İndirmeyi gönderin ve işini okuyun ve JSON'u teslim edin. |
| Storageload credential | Amaç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

```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 · özel dosya

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

- [Windows dosya izinleri](https://flashdata.dev/tr/docs/guides/cli-automation/reference.md#storage)
- [Diğer depolama sağlayıcıları](https://flashdata.dev/tr/docs/sources/youtube_download/reference.md#storage)

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

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

### CLI

#### Seçilen çıktıyı gönderin

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

#### Seçilen çıktıyı gönderin

```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 talep sözleşmesi](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#async)

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

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

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

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

#### CLI

##### Kurtarılan iş için bekleyin

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


#### HTTP / cURL

##### Bir kez daha durumu okuyun

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

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

### CLI

#### Save Kaydet 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 teslimatı JSON · API anahtarını depolama talepleri

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

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

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

- [Verify ve özel bir nesneye hizmet et](https://flashdata.dev/tr/docs/guides/media-delivery-pipeline/reference.md#verify)

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

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

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

- [Son saklama ve saklanan medya](https://flashdata.dev/tr/docs/guides/save-results/reference.md#media)

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

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

| Ne oldu? | Sonraki eylem |
| --- | --- |
| Tamamlanmamış iş ID ile test süresi | kaydedilen CLI koşmak veya tarih talep etmek. Orijinal girişi tutun ve otomatik olarak tekrar göndermeyin. |
| İş kabul etti; zamanı bekleme | Aynı 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ü 403 | Kontrol 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

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

- [Kurtarma kararları](https://flashdata.dev/tr/docs/guides/agent-recovery/reference.md)
- [Hatalar ve durum kodları](https://flashdata.dev/tr/docs/errors/reference.md)
- [Yinelenen görevler](https://flashdata.dev/tr/docs/guides/recurring-tasks/reference.md)

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

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

### Ajan görevi · videoyu, varış ve bütçe tedarik edin

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

- [Uygulama boru hattını inşa edin](https://flashdata.dev/tr/docs/guides/media-delivery-pipeline/reference.md)
