# Corriger l’erreur 429 Too Many Requests de yt-dlp

Suspendez les tâches de l’IP de sortie concernée, espacez les requêtes d’extraction et de sous-titres, puis relancez un seul processus.

Référence canonique : https://flashdata.dev/fr/docs/guides/yt-dlp-429-too-many-requests
Vérifié le 2026-11-13 par FlashData

- [Le tout est en train de se faire 429](https://flashdata.dev/fr/docs/guides/yt-dlp-429-too-many-requests/reference.md#recover) — Arrêtez la sortie et testez après un coulement
- [Seuls les captions échouent](https://flashdata.dev/fr/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing) — Limiter les langues et les demandes de sous-titres de rythme
- [Python méta-détails](https://flashdata.dev/fr/docs/guides/yt-dlp-429-too-many-requests/reference.md#python) — Ajouter un espace entre les sources
- [Le taux d'IP reste limité](https://flashdata.dev/fr/docs/guides/yt-dlp-429-too-many-requests/reference.md#exit-ip) — Tester une sortie de remplacement à la charge inférieure

<a id="recover"></a>

## Suspendez les tâches, attendez, puis faites un essai


1. **Suspendez les tâches sur l’IP concernée.** Arrêtez les processus et les nouvelles tentatives immédiates qui partagent cette IP.
2. **Mettez à jour la version nightly.** Profitez de la pause pour vérifier le paquet et Deno dans l’environnement du processus.
3. **Laissez passer le délai.** Commencez par quelques minutes et respectez l’en-tête `Retry-After` lorsqu’il est présent. Prolongez l’attente si nécessaire.
4. **Testez une seule source.** Si le test réussit, relancez un seul processus à une fréquence réduite.
5. **Changez d’IP de sortie si nécessaire.** Gardez aussi la fréquence réduite sur la nouvelle IP.

**Mise à jour de la staque d'extraction pendant la pause**

```bash
python -m pip install -U --pre "yt-dlp[default,curl-cffi]"
python -m yt_dlp --version
deno --version
```

**Une étude de métadonnées après le cooldown**

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

Ces paramètres accélèrent ce processus; ils ne cessent pas d'autres processus utilisant le même IP.

**Still recevoir 429?** Attendre plus longtemps ou changer la sortie. mise à jour yt-dlp ne réinstalle pas un limite de taux IP existant; le test du manifeste complet ne ajoute que la charge.

<a id="identify"></a>

## Trouver la demande étant limitée


| Travail échoué | Pourquoi cela peut générer de nombreuses demandes | Première réduction |
| --- | --- | --- |
| Vidéo / requêtes de joueurs | Une extraction complète peut capter plusieurs réponses de joueurs et les ressources de support. | Une extraction par source ; réutiliser son résultat dans le même travail. |
| Recherche / canal / liste de lecture | Les grands groupes de résultats nécessitent des demandes de continuation répétées. | Lient les résultats demandés, persiste les identifiants découverts et évite de répéter l'ensemble de l'écran. |
| Traces / Traces de transcription | Chaque langue ou traduction demandée peut ajouter une demande d'enregistrement. | Demandez uniquement les langues nécessaires et ajoutez un sommeil spécifique à la sous-titre. |
| Médias / Fragments | Les vidéos parallèles et les flux fragmentés partagent le budget de la demande de sortie. | Réduire les processus, la concurrence de fragments et les connexions de téléchargement externes. |

Lire le nom d'hôte et la ligne immédiatement avant 429. Un timedtext/caption faut vous envoyer à la sous-titre de pacing; une demande de joueur doit vous envoyer à la pacing d'extraction. Changement des codecs MP4 ou limitation des bytes médias ne ralentit pas un métadonnées-uniquement le courant.

Si yt-dlp affiche `Sign in to confirm you’re not a bot`, suivez le guide de vérification anti-bot. Une IP signalée peut rester bloquée au-delà d’une limitation temporaire. Pour une erreur 403 lors du téléchargement du média, suivez le guide consacré aux erreurs 403.

- [Les contrôles de sign-in de bot](https://flashdata.dev/fr/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Les médias HTTP 403](https://flashdata.dev/fr/docs/guides/yt-dlp-403-forbidden/reference.md)

<a id="pacing"></a>

## Utilisez le bon contrôle de taux


| Contrôle | Le scène | Ce qu'il ne résout pas |
| --- | --- | --- |
| --sleep-requests 3 | Retard entre les demandes d'extraction dans ce téléchargement. | Coordination parmi d’autres employés ou toutes les appels API séparés dans votre application. |
| --sleep-subtitles 5 | Retard avant chaque sous-titre de téléchargement. | Une couverture qui demande toujours chaque langue disponible parmi de nombreux processus. |
| --sleep-interval 5 --max-sleep-interval 10 | Attendre avant les téléchargements de médias. | Un loop utilisant le download=False ou --skip-download pour les métadonnées uniquement. |
| --concurrent-fragments 1 | Un fragment de concurrence dans un travail médiatique. | Le nombre de processus séparés yt-dlp. |
| --limit-rate 2M | Transfert de bande passante. | Recherche, fréquence de la demande de joueur ou de transcription. |
| Un partage par-exit queue | Le total des emplois actifs et la demande se font à travers un seul IP de sortie. | Une IP est déjà limitée par des locataires ou des emplois non liés. |

**Réservez uniquement les traces sélectionnées, avec le pacing**

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

Utilisez un seul label de langue, comme en si votre ensemble de données ne nécessite que ce tracé. en.* peut demander plusieurs variantes.

Les chiffres ci-dessus sont les paramètres de départ pour une récupération contrôlée, pas des quotas publiées. Augmenter l’espace lorsque le rejet revient. Enregistrez l'efficace IP de sortie et le nombre de processus en plus des erreurs afin qu'un processus nouvellement démarré ou un proxy partagé ne multiplie pas silencieusement la demande.

<a id="python"></a>

## Python : les méta-dats de rythme ne sont que des emplois


Avec download=False, les sommes de téléchargement de médias ne sont pas un calendrier de travail. Ajoutez un retard entre les sources et sleep_interval_requests à l'intérieur yt-dlp. Commencez séquentiellement, arrêtez une échec et classez l'erreur avant de décider quand le retracer.

**Un processus de métadonnées délibérément séquentiel**

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

Créer urls.txt avec un URL vidéo par ligne. cet exemple minimum s'arrête sur toute erreur de téléchargement; une chaîne de production devrait classifier les échecs, les identifiants de points de contrôle et empêcher les dossiers dupliqués sur le résumé.

Ne détecter pas chaque échec de YouTube en cherchant une seule ligne de message d'erreur et endémiquement dormire. Gardez les éléments échoués avec leur erreur et essayez de compter. Un cooldown partagé appartient à l’IP de sortie ou à la session, tandis qu’un vidéo inaccessible est un échec au niveau d’objet. Les autres processus doivent respecter le même coulard.

<a id="exit-ip"></a>

## Remplacer une sortie qui reste limitée


Sur une connexion directe, cela signifie un autre utilisable host/network égrès. Avec un proxy, cela signifie une sortie proxy différente, pas seulement une adresse de porte différente. Arrêtez les anciens ouvriers avant de tester le remplacement et maintenez les mêmes paramètres à faible charge.

**Un test contrôlé par une sortie de remplacement**

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

Pour un emploi médiatique, gardez cette sortie stable de l'extraction par le transfert; tourner entre les emplois ou avant une nouvelle retraite. Un bassin proxy ne permet de distribuer le travail en masse que lorsque les sorties du bassin sont utilisables et que la vitesse par sortie est contrôlée. Si le remplacement touche immédiatement 429 aussi, inspectez l'utilisation partagée et la couche plutôt que de la rotation accélérée.

- [Tests de sortie-IP et séances de détachement](https://flashdata.dev/fr/docs/guides/yt-dlp-403-forbidden/reference.md#environment)

<a id="resume"></a>

## Récupérer sans répéter le travail terminé


1. Retourner l’opération faillite exacte: métadonnées, page de recherche, trace d’affichage ou flux médiatique.
2. Démarrez un processus et observez plusieurs éléments.Restourcez la concurrence progressivement, avec un limite par IP.
3. Réutiliser les identifiants découverts et les métadonnées existantes au lieu de répéter chaque recherche et extraction.
4. Gardez les langues demandées explicites et retirez seulement les traces manquantes.
5. Utilisez des retraites limitées avec des vagues et des jitters en joint dans la couche. Arrêtez de retraire immédiatement lorsque la même sortie est rejetée.

Maintenir les médias séparés et les états de signature. Si MP4 a été terminé mais les captions ont 429, gardez le fichier et prévoyez une réparation d'un titre. La récupération des médias ajoute la charge et ne définit pas encore la complétité du texte. Un seul archive de médias n’est pas un record de couverture d’enregistrements.

- [Médias de données et inventeurs](https://flashdata.dev/fr/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [Python processus et enregistrements de finition](https://flashdata.dev/fr/docs/guides/yt-dlp-python-api/reference.md)
- [429 guides](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#http-error-429-too-many-requests-or-402-payment-required)
- [Guide de la demande YouTube](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#this-content-isnt-available-try-again-later)
