Saltar al contenido
ES
Obtener clave API
Explorar documentación

Guías

Solucionar el error 429 Too Many Requests de yt-dlp

Pausa la IP de salida afectada, reduce la frecuencia de las solicitudes de extracción y subtítulos y reanuda un solo proceso.

En esta página

Pasar, enfriar, luego probar una vez

  1. Por la IP afectada. Dejar de todos los trabajadores y retrasos inmediatos compartir esa salida.
  2. Agricula por la noche. Verifique el paquete del trabajador y Deno durante la pausa.
  3. Desea un alquiler. Comienza con unos minutos; honra Retry-After cuando se suministra y espera más tiempo si es necesario.
  4. Test One Source. Recibe un trabajador de la prueba sólo después de que el test sea exitoso.
  5. Remplaza la salida si es necesario. Mantenga la tasa de solicitud más baja en el nuevo IP también.
Actualiza la estaca de extracción durante la pausa
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
Un estudio de metadatos después del 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"
Estas configuraciones acelera este proceso; no detienen otros procesos utilizando el mismo IP.

Still getting 429? Espere más tiempo o cambie la salida. actualizar yt-dlp no restablece un límite de tasa IP existente; prueba del manifiesto completo sólo añade carga.

Encuentra la solicitud con un precio limitado

Trabajo fallido¿Por qué puede generar muchas solicitudes?Primera reducción
Video metadatos / solicitudes de jugadorUna extracción completa puede captar varias respuestas de jugadores y recursos de apoyo.Una extracción por fuente; reutilizar su resultado dentro del mismo trabajo.
Busca / canal / lista de playlistLos grandes conjuntos de resultados requieren solicitudes repetidas de continuidad.Limitar los resultados solicitados, persistir los ID descubiertos y evitar repetir toda la escanea.
Transcript / Traces de la imagenCada lenguaje o traducción solicitada puede agregar una solicitud de nota.Solicite sólo las lenguas necesarias y añade un sueño específico de subtitulos.
Medios / FragmentosVídeos paralelos y flujos fragmentados comparten el presupuesto de la solicitud de salida.Reducir los trabajadores, la concorrencia de fragmentos y las conexiones de descarga externa.

Lea el nombre de host y la línea inmediatamente antes 429. Un error timedtext/caption debe enviarle a la subtitulación de pacto; una solicitud de jugador debe enviarle a la extracción de pacto. Cambiar codecos MP4 o limitar bajos de medios no retarda un solo giro de metadatos.

Si yt-dlp muestra Sign in to confirm you’re not a bot, consulta la guía de verificación de bots. Una IP marcada puede seguir bloqueada más tiempo que un límite temporal. Si la descarga del archivo devuelve 403, consulta la guía de errores 403.

Utilice el control de la tasa correcta

ControlalcanceLo que no soluciona
--sleep-requests 3Descargar entre las solicitudes de extracción dentro de este descargador.Coordinación entre otros trabajadores o todas las llamadas de API separadas en su aplicación.
--sleep-subtitles 5Después de descargar cada subtitulo.Una cueva que todavía pide cada lengua disponible a través de muchos trabajadores.
--sleep-interval 5 --max-sleep-interval 10Espera antes de que los medios de comunicación se descarguen.Un loop que utiliza download=False o --skip-download para los metadatos solo.
--concurrent-fragments 1La concorrencia de fragmentos nativos dentro de un trabajo de medios.El número de procesos separados yt-dlp.
--limit-rate 2MTransmisión de banda.Frecuencia de solicitud de búsqueda, jugador o transcript.
Una cueva compartida por salidaTotal de empleos activos y solicitudes se desploman a través de una IP de salida.Un IP ya está siendo la tasa limitada por inquilinos o empleos no relacionados.
Colectar solo las pistas seleccionadas, 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"
Utilice una etiqueta de lenguaje única, como en si su conjunto de datos sólo necesita esa pista. en.* puede solicitar varias variantes.

Los números anteriores son las configuraciones de inicio para una recuperación controlada, no publica cuotas. Aumentar el espacio cuando la rechaza vuelve. Recordar el IP de salida efectivo y el número de trabajadores junto con los errores para que un trabajador recién iniciado o un proxy compartido no multiplica tranquilamente la tasa de solicitud.

Exemplo de Python: metadatos de ritmo solo trabajos

Con download=False, los sueños de descarga de medios no son un programa de trabajo. Añade un retraso entre las fuentes y sleep_interval_requests dentro de yt-dlp. Comienza secuencialmente, detiene un fallo y clasifica el error antes de decidir cuándo retirarlo.

Un trabajador de metadatos deliberadamente secuencial
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()
Crea urls.txt con una URL de vídeo por línea.Este ejemplo mínimo se detiene en cualquier error de descarga; un cajón de producción debe clasificar fallos, IDs de punto de verificación y evitar duplicar los registros en el resumen.

No detectes cada fallo de YouTube buscando una línea de mensajes de error y dormido sin fin. Mantener los artículos fallidos con su error y intentar contar. Un cooldown compartido pertenece a la salida IP o sesión, mientras que un vídeo inaccesible es un fracaso de nivel de elemento. Los demás trabajadores deben respetar el mismo cooldown.

Substituir una salida que permanezca con un ritmo limitado

En una conexión directa, esto significa un diferente uso host/network egreso. Con un proxy, significa una salida proxy diferente, no simplemente una dirección de puerta diferente. Detener los trabajadores antiguos antes de probar la sustitución y mantener las mismas configuraciones de baja carga.

Un test controlado a través de una salida de reemplazo
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"

Para un trabajo de medios, mantenga esta salida estable desde la extracción a través del traslado; rotar entre los trabajos o antes de una nueva retrea. Una piscina de proxy ayuda a distribuir el trabajo en gran medida sólo cuando las salidas de la piscina son usables y la tasa por salida se controla. Si el sustituto ataca inmediatamente 429 también, inspeccione el uso compartido y la cola en lugar de acelerar la rotación.

Recuerda sin repetir el trabajo terminado

  1. Retirar la operación exata que no funciona: metadatos, página de búsqueda, pista de comentarios o flujo de medios.
  2. Comienza un trabajador y observe varios elementos. Restablecer la concorrencia gradualmente, con un límite por IP.
  3. Reutilizar los identificadores descubiertos y los metadatos existentes en lugar de repetir cada búsqueda y extracción.
  4. Mantenga las lenguas solicitadas de la nota explícita y retire sólo las pistas que faltan.
  5. Utilice retrasas limitadas con aumento de los espaldos y la cuna en la cueva compartida. Deje de retrasar inmediatamente cuando se rechaza de nuevo la misma salida.

Mantener separados medios y Estados de la nota. Si MP4 se ha completado pero las capciones se han obtenido 429, mantiene el archivo y planifique una reparación de la nota. La redimensionamiento de los medios añade carga y todavía no establece la integridad del texto. Un archivo de medios no es un registro de cobertura de comentarios.