Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Посібники

Як виправити помилку 429 Too Many Requests у yt-dlp

Призупиніть завдання на обмеженій вихідній IP-адресі, зменште частоту запитів на видобування й отримання субтитрів, а тоді відновіть один процес.

На цій сторінці

Відпочинок, охолодження, а потім тест один раз

  1. Звичайно, через вплив IP. Забороняється всі працівники і негайні пенсії, які діляться цим виходом.
  2. Оновлюйте нічно. Перевірте пакету працівника і Deno під час перерви.
  3. Дозвольте холодильнику. Почніть з декількох хвилин; поважайте Retry-After, коли це буде поставлено, і чекайте більше, якщо це необхідно.
  4. Тест одного джерела. Оновлюйте одного працівника тільки після того, як тест пройде.
  5. Замінити вихід, якщо це необхідно. Зберігайте нижчу швидкість запиту на новому IP також.
Оновлення екстракційної стаки під час паузи
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
Мета-даточні дослідження після холодної гори
python -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"
Ці налаштування прискорюють цей процес; вони не зупиняють інші процеси, використовуючи той же IP.

Постань отримувати 429? Чекайте довше або змінюйте вихід. Оновлення yt-dlp не перестає встановлювати існуючий обмеження швидкості IP; тестування повного манифесту тільки додає навантаження.

Знайти, що замовлення обмежено

Невдача роботиЧому це може викликати багато запитівПерша скорочення
Метадани відео / запити гравцівПовний екстракція може завоювати кілька відгуків гравців і підтримувати ресурси.Один екстракція за джерелом; повторне використання її результату в межах тієї ж роботи.
Пошук / канал / перелік перелікуВеликі результати комплекту вимагають повторних запитів продовження.Зв'яжіть запитувані результати, тримайтеся з відкритими ідентифікаторами і уникайте повторювати весь сканування.
Переклад / переклад тракКожен затребуваний мову або переклад може додати запит на відгуки.Запитайте тільки потрібні мови і додайте субтитри-специфічний сон.
Медіа / ФрагментиПаралельні відео та фрагменти передачі поділяють бюджет запиту про вихід.Зменшити робочих місць, фрагмент конкуренції та зовнішні з'єднання завантажувачів.

Прочитайте прізвище і лінію відразу перед 429. Помилка timedtext/caption повинна відправити вас на підзаголовок; запит гравця повинен відправити вас на екстракційну пакету. Зміна MP4 кодексів або обмеження медіа-байтів не прискорює метаданний-тільки ход.

Якщо yt-dlp показує Sign in to confirm you’re not a bot, скористайтеся посібником із перевірки на бота. Позначена IP-адреса може залишатися заблокованою довше, ніж діє тимчасове обмеження частоти запитів. Якщо під час завантаження медіа виникає помилка 403, перегляньте окремий посібник.

Використовуйте правильний контроль

КонтрольОбсягЩо не вирішує
--sleep-requests 3Затримка між вимогами до витягування в цьому завантажувачі.Координація між іншими працівниками або всі окремі дзвінки API у вашій заявці.
--sleep-subtitles 5Затримка перед кожним завантаженням субтитра.Стіна, яка все ще вимагає кожного доступного мови у багатьох працівників.
--sleep-interval 5 --max-sleep-interval 10Рандомизований очікування до завантаження медіа.Завантажити або завантажити (завантажити) або завантажити (завантажити) за допомогою --skip-download для метаданів.
--concurrent-fragments 1Народні фрагменти конкуренції в межах однієї медіа-послуги.Кількість окремих процесів yt-dlp
--limit-rate 2MМедіа передача пропускної ширини.Частота пошуку, переглядача або транскриптового запиту.
Подільна квітка за вихідЗагальна активна робота і запит вибухають через один IP-відхід.IP вже обмежена ставка не пов'язаних наймачів або робочих місць.
Збирайте тільки вибрані відгуки, з пакетом
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"
Використовуйте єдиний етикет, наприклад, en, якщо ваш набір даних потребує тільки того сліду. en.* може вимагати кілька варіантів.

Вищезазначені цифри є початковими налаштуваннями для контролюваного відновлення, не опублікованих квотів. Збільшення проміжок, коли відмова повертається. Запишіть ефективний IP-адрес виходу і кількість працівників разом з помилками, щоб новозапущений працівник або спільний прокси не спокійно збільшував швидкість запиту.

Приклад Python: темп метаданни-лише робочі місця

З Download=False, Media-download сні не є робочим графіком. Додайте затримку між джерелами, а також sleep_interval_requests всередині yt-dlp. Почніть послідовно, зупиніть невдалий біг і класифікуйте помилку, перш ніж вирішити, коли відкликати її.

Намірно-секунтивний метаданний працівник
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()
Створіть urls.txt з одним URL-адресом відео за лінією. Цей мінімальний приклад зупиняється на будь-якій помилці з завантаження; виробничий корпус повинен класифікувати невдачі, ідентифікатори пунктів перевірки і запобігати подвійним записам на рециві.

Не відзначайте кожну невдачу YouTube, шукаючи одну смугу помилок-повідомлення і безмежно заснути. Зберігайте невдалі елементи з їх помилкою і намагайтеся рахувати. Поділена холодильна завантаження належить до IP або сесії виходу, в той час як недоступне відео є невдачею на рівні елементів. Інші працівники повинні поважати той же холодний домівок.

Замінити вихід, який залишається обмеженою ставками

У зв'язку з цим, це означає інший корисний host/network егрес. При проксі це означає інший проксі-вихід, а не просто інший портал-адрес. Затримати старих працівників перед тим, як перевірити заміну і зберігати ті ж самі налаштування низької завантаження.

1 контрольований тест через заміну виходу
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"

Для медіа-роботи, зберігайте цей вихід стабільним від екстракції через перевезення; ротація між роботами або перед свіжим відступленням. Прокси-поля допомагає розподіляти масивну роботу тільки тоді, коли вихід басейну є доступним і контролюється швидкість на вихід. Якщо заміна також негайно потрапляє 429, перевірте спільне використання і хвост, а не прискорюючи ротацію.

Резюме без повторення завершеної роботи

  1. Відновлення точної невдалої операції: метадані, сторінка пошуку, трак заголовок або потоку засобів масової інформації.
  2. Почніть один працівник і спостерігайте за кількома пунктами. Відновлюйте конкуренцію поступово, з обмеженням на IP.
  3. Повторне використання знайдених ідентифікаторів та існуючих метадатів замість повторення кожного пошуку та видобутку.
  4. Зберігайте запитовані записні мови чітко і відмовляйтеся тільки від відсутніх сходин.
  5. Використовуйте обмежені відставки з збільшенням чатів і джитер в спільній хвостці. припиніть відступ відразу, коли той же вихід знову відкидається.

Зберігати окремі медіа і штати запізнення. Якщо MP4 завершено, але ухвалення отримали 429, зберігайте файл і плануйте відновлення заголовок. Перезавантаження засобів масової інформації додає навантаження і все ще не встановлює повноту тексту. Саме медіа-архіви не є записом з назвою покриття.