Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Guide

Risolvere l’errore 429 Too Many Requests di yt-dlp

Sospendi le attività sull’IP di uscita interessato, riduci la frequenza delle richieste di estrazione e sottotitoli e riavvia un solo processo.

In questa pagina

Parate, raffreddate e poi testate una volta

  1. Perché l'IP è colpito. Stop tutti i lavoratori e immediatamente pensionati condividono quella uscita.
  2. Aggiornare di notte. Verificare il pacchetto del lavoratore e Deno durante la pausa.
  3. Permettere un raffreddore. Inizia con pochi minuti; onore Retry-After quando fornito e aspettare più a lungo se necessario.
  4. Test una fonte. Rispondere un lavoratore in grado solo dopo che il test è riuscito.
  5. Risposta la uscita se necessario. Mantenere anche il tasso di richiesta inferiore sul nuovo IP.
Aggiornare la stack di estrazione durante la pausa
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
Una ricerca di metadati dopo il cooldown
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"
Questi impostazioni ritengono questo processo; non fermano altri processi utilizzando lo stesso IP.

Still ottenere 429? Aspettare più o cambiare la uscita. aggiornamento yt-dlp non ristabili un limite di tasso IP esistente; il test del manifesto completo aggiunge solo carico.

Trova la richiesta limitata

Lavoro fallitoPerché può generare molte richiestePrima riduzione
Video / richieste di metadatiUn'estrazione completa può ottenere diverse risposte giocatori e risorse di supporto.Una estrazione per fonte; riutilizzare il suo risultato all'interno dello stesso lavoro.
Search / canale / playlist elencoI grandi set di risultati richiedono richieste ripetute di continuazione.Limitare i risultati richiesti, persistere le ID scoperte e evitare di ripetere l'intero scansione.
Trascrizione / taglio tracceOgni lingua o traduzione richiesta può aggiungere una richiesta di taglio.Richiedi solo le lingue necessarie e aggiungi sonno specifico per sottotitoli.
Media / FragmentiI video paralleli e i flussi fragmentati condividono il bilancio della richiesta di uscita.Ridurre i lavoratori, la concorrenza di fragmenti e le connessioni di download esterne.

Leggi il nome dell'host e la linea immediatamente prima 429. Un errore timedtext/caption dovrebbe inviare a subtitle pacing; una richiesta di giocatore dovrebbe inviare a pacing extrazione. Modificare i codec MP4 o limitare i byte di media non rallenta un metadato-solo loop.

Se yt-dlp mostra Sign in to confirm you’re not a bot, segui la guida alla verifica anti-bot. Un IP segnalato può restare bloccato più a lungo di un limite temporaneo. Se il download dei media restituisce 403, consulta la guida agli errori 403.

Utilizzare il giusto controllo delle tasse

ControlloscalaCosa non risolve
--sleep-requests 3Ritardi tra le richieste di estrazione all'interno di questo download.Coordinamento tra altri lavoratori o tutte le chiamate API separate nella tua applicazione.
--sleep-subtitles 5Ritorno prima di ogni sottotitolo.Un'antica coda che chiede ancora ogni lingua disponibile in molti lavoratori.
--sleep-interval 5 --max-sleep-interval 10Attendere prima di scaricare i media.Un loop utilizzando download=False o --skip-download solo per i metadati.
--concurrent-fragments 1La concorrenza del fragmento nativo all'interno di un lavoro di media.Il numero di processi separati yt-dlp.
--limit-rate 2MTrasferimento di banda media.Frequenza di richiesta di ricerca, giocatore o trascrizione.
Un’altra quota per uscitaIl totale di posti di lavoro attivi e richieste si spalancano attraverso un'IP di uscita.Un IP già in tasso limitato da inquilini o posti di lavoro non correlati.
Collezione solo tracce selezionate, con pacing
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"
Utilizzare un singolo tag linguistico come en se il tuo set di dati ha solo bisogno di quella traccia. en.* può richiedere più varianti.

I numeri sopra sono le impostazioni di avvio per una recupero controllata, non pubblicate quote. Aumentare lo spazio quando il rifiuto ritorna. Il numero di uscita efficaci IP e il numero dei lavoratori è registrato insieme agli errori, in modo che un lavoratore appena iniziato o un proxy condiviso non moltiplicino tranquillamente la tasso di richiesta.

Python: i metadati di ritmo sono solo lavori

Con download=False, i sonni di download dei media non sono un programma di lavoro. Aggiungi un ritardo tra le fonti e sleep_interval_requests all'interno yt-dlp. Inizia sequenzialmente, ferma un fallimento e classifica l'errore prima di decidere quando ritirarlo.

Un lavoratore deliberatamente sequenziale dei metadati
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()
Creare urls.txt con un URL video per linea.Questo esempio minimo si ferma su qualsiasi errore di download; un cavo di produzione dovrebbe classificare fallimenti, ID di checkpoint e prevenire i record duplicati sul ritorno.

Non rilevare ogni fallimento di YouTube cercando una riga di messaggi di errore e senza fine dormire. Mantenere gli articoli falliti con il loro errore e tentativo di contare. Un cooldown condiviso appartiene all'IP o alla sessione di uscita, mentre un video inutilizzato è un fallimento a livello di oggetto. Gli altri lavoratori devono rispettare lo stesso cooldown.

sostituire una uscita che rimane limitata

In un collegamento diretto, questo significa un'altra utilizzabile host/network eruzione. Con un proxy, significa una uscita proxy diversa, non solo un indirizzo di gateway diverso. Fermare i vecchi lavoratori prima di testare la sostituzione e mantenere le stesse impostazioni a basso carico.

Un test controllato attraverso una uscita sostitutiva
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"

Per un lavoro di media, mantenere questa uscita stabile dall'estrazione attraverso il trasferimento; girare tra lavori o prima di una nuova ritrazione. Un pool proxy aiuta a distribuire il lavoro di massa solo quando le uscite del pool sono utili e la velocità per uscita è controllata. Se il cambio colpisce immediatamente 429 anche, controllare l'uso condiviso e la coda piuttosto che accelerare la rotazione.

Rispettare senza ripetere il lavoro completato

  1. Ritorna l’operazione non funzionante: metadati, pagina di ricerca, traccia di segnalazione o flusso di media.
  2. Inizia un operaio e segui diversi elementi.Ristrutturare la concorrenza gradualmente, con un limite per IP.
  3. Ripristinare i dati identificativi e i metadati esistenti invece di ripetere ogni ricerca e estrazione.
  4. Mantenere le lingue richieste esplicitamente e ritirare solo i sentieri mancanti.
  5. Utilizzare retrazioni limitate con crescente spinta e gettura nella coda condivisa. smettere di ritirarsi immediatamente quando la stessa uscita viene rifiutata di nuovo.

Mantenere separati i media e gli stati di segnalazione. Se MP4 è stato completato ma le capture sono state 429, mantenere il file e programmare una riparazione di taglio. Il ricarico dei media aggiunge carico e non stabilisce ancora la completa integrità del testo. Un archivio dei media non è un record di copertura.