Jelajahi dokumentasi
Panduan
Jeda proses pada IP keluar yang terdampak, kurangi laju permintaan ekstraksi dan subtitel, lalu lanjutkan satu proses.
Di halaman ini
Berhenti, mendinginkan, kemudian coba sekali
- Karena IP yang terjebak. Hentikan semua pekerja dan pensiun segera berbagi keluar itu.
- Memperbarui di malam hari. Periksa paket dan Deno pekerja selama istirahat.
- Biarkan sebuah kolam dingin. Mulai dengan beberapa menit; hormat
Retry-Afterketika dibekalkan dan tunggu lebih lama jika perlu. - Test satu sumber. Mengembalikan satu pekerja yang dipekerjakan hanya setelah ujian berhasil.
- Tukar output jika perlu. Tetaplah tingkat permintaan yang lebih rendah pada IP baru juga.
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --versionpython -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--sleep-requests 3 --extractor-retries 1 --skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Still mendapatkan 429? Tunggu lebih lama atau ubah output. update yt-dlp tidak menetapkan kembali batas kadar IP yang ada; menguji manifest penuh hanya menambah beban.
Cari permintaan yang terbatas
| Kegagalan kerja | Mengapa bisa menghasilkan banyak permintaan | Pengurangan Pertama |
|---|---|---|
| Video Metadata / Permintaan Pemain | Sebuah ekstraksi penuh dapat menangkap beberapa respons pemain dan sumber daya dukungan. | Satu ekstraksi per sumber; menggunakan hasilnya di dalam pekerjaan yang sama. |
| Search / channel / playlist daftar | Set hasil yang besar membutuhkan permintaan berulang. | Mengikat hasil yang diminta, tetap mengidentifikasi ID yang ditemukan dan menghindari mengulangi keseluruhan pemindaian. |
| Transcript / caption track | Setiap bahasa atau terjemahan yang diminta dapat menambahkan permintaan caption. | Meminta bahasa yang diperlukan dan tambahkan subtitle-specific sleep. |
| Media / Fragmen | Video paralel dan arus terpecah belah berbagi anggaran permintaan keluar. | Mengurangi pekerja, konversi fragmen dan koneksi download eksternal. |
Baca nama host dan baris sebelum 429. Kesalahan timedtext/caption harus mengirimkan Anda ke subtitle pacing; permintaan pemain harus mengirimkan Anda ke extraction pacing. Mengubah MP4 codec atau membatasi media byte tidak memperlambat satu metadata-hanya loop.
Jika yt-dlp menampilkan Sign in to confirm you’re not a bot, ikuti panduan pemeriksaan bot. Alamat IP yang ditandai bisa tetap diblokir lebih lama daripada pembatasan sementara. Jika unduhan media mengalami galat 403, ikuti panduan khusus galat 403.
Gunakan kontrol tingkat yang tepat
| Kontrol | jangkauan | Apa yang tidak diselesaikan |
|---|---|---|
| --sleep-requests 3 | Menunda antara permintaan ekstraksi di dalam download ini. | Koordinasi antara karyawan lain atau semua panggilan API yang terpisah dalam aplikasi Anda. |
| --sleep-subtitles 5 | Tunda sebelum setiap subtitle download. | Sebuah kue masih meminta setiap bahasa yang tersedia di antara banyak pekerja. |
| --sleep-interval 5 --max-sleep-interval 10 | Tunggu sebelum media download. | Sebuah loop menggunakan download=False atau --skip-download untuk metadata saja. |
| --concurrent-fragments 1 | Konkursus fragmen asli dalam satu pekerjaan media. | Jumlah proses yang terpisah yt-dlp |
| --limit-rate 2M | Media transfer bandwidth. | Frekuensi permintaan pencarian, pemain atau transcript. |
| Perbedaan Per-Exit Queue | Total pekerjaan aktif dan permintaan meletus melalui satu output IP. | IP yang sudah terbatas oleh penyewa atau pekerjaan yang tidak terkait. |
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--skip-download --write-subs --write-auto-subs --sub-langs "en.*" --sub-format "vtt/best" \
--sleep-requests 3 --sleep-subtitles 5 -P captions -o "%(id)s.%(ext)s" \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Angka di atas adalah pengaturan awal untuk pemulihan terkontrol, kuota tidak diterbitkan. Meningkatkan ruang ketika penolakan kembali. Mencatat IP output yang efektif dan pekerja menghitung bersama dengan kesalahan sehingga pekerja baru dimulai atau proxy yang dikongsi tidak diam-diam mengalikan kadar permintaan.
Contoh Python: Metadata Kelajuan-Hanya Pekerjaan
Dengan download=False, media-download tidur tidak menjadi jadwal pekerjaan. Kemudian ditambahkan keterlambatan antara sumber dan sleep_interval_requests di dalam yt-dlp. Mulai secara berurutan, berhenti berjalan gagal dan mengklasifikasikan kesalahan sebelum memutuskan kapan untuk menariknya kembali.
import json
import random
import time
from pathlib import Path
from yt_dlp import YoutubeDL
from yt_dlp.networking.impersonate import ImpersonateTarget
from yt_dlp.utils import DownloadError
sources = list(dict.fromkeys(
line.strip() for line in Path("urls.txt").read_text().splitlines()
if line.strip() and not line.lstrip().startswith("#")
))
options = {
"js_runtimes": {"deno": {}},
"impersonate": ImpersonateTarget(),
"noplaylist": True,
"sleep_interval_requests": 3,
"extractor_retries": 1,
}
with Path("metadata.jsonl").open("a", encoding="utf-8") as records:
for index, source in enumerate(sources):
if index:
time.sleep(random.uniform(5, 10))
try:
with YoutubeDL(options) as downloader:
info = downloader.extract_info(source, download=False)
except DownloadError:
# Do not immediately replay a failing queue. Inspect the error;
# cool down the exit before restarting after a rate limit.
raise
record = {key: info.get(key) for key in (
"id", "webpage_url", "title", "channel_id", "duration"
)}
records.write(json.dumps(record, ensure_ascii=False) + "\n")
records.flush()Jangan mendeteksi setiap kegagalan YouTube dengan mencari satu baris pesan kesalahan dan tidur tanpa henti. Tetap item yang gagal dengan kesalahan mereka dan mencoba menghitung. Sebuah kolam yang dikongsi adalah bagian dari output IP atau sesi, sementara video yang tidak tersedia adalah kegagalan tingkat item. Para pekerja lain harus menghormati kolam yang sama.
Mengganti output yang tetap terbatas
Pada sambungan langsung, ini berarti suatu kegunaan yang berbeda host/network. Dengan proxy, itu berarti keluar proxy yang berbeda, bukan hanya alamat gateway yang berbeda. Hentikan pekerja lama sebelum menguji penggantian dan tetap seting low-load yang sama.
python -m yt_dlp --ignore-config --js-runtimes deno --impersonate="" --verbose --no-playlist \
--proxy "http://USER:PASSWORD@HOST:PORT" --sleep-requests 3 --extractor-retries 1 \
--skip-download --write-info-json -P diagnostics \
"https://www.youtube.com/watch?v=jNQXAC9IVRw"Untuk pekerjaan media, tetaplah keluar itu stabil dari ekstraksi melalui transfer; berputar antara pekerjaan atau sebelum penarikan segar. Sebuah kolam proxy membantu mengedarkan kerja besar-besaran hanya ketika output kolam dapat digunakan dan kadar per output dikendalikan. Jika pengganti langsung menabrak 429 juga, periksa penggunaan bersama dan tali bukannya mempercepat rotasi.
Mengulang tanpa mengulangi kerja selesai
- Mengembalikan operasi yang gagal: metadata, halaman pencarian, track caption atau media stream.
- Mulai satu pekerja dan perhatikan beberapa item. mengembalikan persaingan secara bertahap, dengan batas per IP.
- Menggunakan ID yang ditemukan dan metadata yang ada, bukannya mengulangi setiap pencarian dan ekstraksi.
- Tetap bahasa yang diminta dengan jelas dan hanya mengundurkan diri dari jalur yang hilang.
- Gunakan retries terbatas dengan peningkatan waits dan jitter dalam kue yang dikongsi. berhenti retrying segera ketika keluar yang sama ditolak lagi.
Mengekalkan media dan negara-negara yang terpisah. Jika MP4 selesai tetapi captions mendapat 429, simpan file dan jadikan pembaikan tag. Mengunduh ulang media menambah beban dan masih tidak menetapkan kesempurnaan teks. Sebuah media archive sendiri tidak merupakan rekaman covering caption.