# Como corrigir o erro 429 Too Many Requests do yt-dlp

Pause as tarefas no IP de saída afetado, reduza a frequência de pedidos de extração e legendas e retome um único processo.

Referência canônica: https://flashdata.dev/pt/docs/guides/yt-dlp-429-too-many-requests
2026-11-13 por FlashData

- [A Cidade inteira é a Cidade 429](https://flashdata.dev/pt/docs/guides/yt-dlp-429-too-many-requests/reference.md#recover) — Parar a saída e testar após um cooldown
- [Somente capturas falham](https://flashdata.dev/pt/docs/guides/yt-dlp-429-too-many-requests/reference.md#pacing) — Limitações de idiomas e pedidos de subtitulos de ritmo
- [Python Metadados Louvado](https://flashdata.dev/pt/docs/guides/yt-dlp-429-too-many-requests/reference.md#python) — Adicionar espaço entre fontes
- [IP fica limitado](https://flashdata.dev/pt/docs/guides/yt-dlp-429-too-many-requests/reference.md#exit-ip) — Testar uma saída de substituição em carga mais baixa

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

## Descanse, arrefece e depois teste uma vez


1. **Por causa do IP afetado.** Parar todos os trabalhadores e aposentadorias imediatas compartilhar essa saída.
2. **Atualiza-se à noite.** Verifique o pacote do trabalhador e o Deno durante a pausa.
3. **Dê uma cooldown.** Começa com alguns minutos; honra `Retry-After` quando fornecido e espera mais tempo se necessário.
4. **Teste uma fonte.** Resume um trabalhador embalado somente depois que o teste seja bem sucedido.
5. **Respondo a saída se necessário.** Mantenha a taxa de solicitação mais baixa no novo IP também.

**Atualização do estágio de extração durante a pausa**

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

**Uma pesquisa de metadados após o 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"
```

Essas configurações acelera este processo; eles não param outros processos usando o mesmo IP.

**Permite obter 429?** Espere mais tempo ou altera a saída.Atualização yt-dlp não restaura um limite de taxa IP existente; testando o manifesto completo só adiciona carga.

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

## Encontre a solicitação sendo taxa limitada


| Trabalho falhado | Por que pode gerar muitas solicitações | Primeira redução |
| --- | --- | --- |
| Video metadados / pedidos de jogador | Uma extração completa pode capturar várias respostas de jogador e recursos de suporte. | Uma extração por fonte; reutilizar o resultado dentro do mesmo trabalho. |
| Search / canal / playlist enumeration | Os grandes conjuntos de resultados exigem pedidos repetidos de continuação. | Limite os resultados solicitados, persiste os IDs descobertos e evite repetir toda a escaneamento. |
| Transcript / Track de Ação | Cada idioma ou tradução solicitado pode adicionar uma solicitação de nota. | Solicite apenas as línguas necessárias e adicione sono específico de subtitulo. |
| Mídia / Fragmentos | Vídeos paralelos e fluxos fragmentados compartilham o orçamento de solicitação de saída. | Reduzir os trabalhadores, a concorrência de fragmentos e as conexões de download externos. |

Leia o nome do anfitrião e a linha imediatamente antes 429. Um erro timedtext/caption deve enviar-lhe para o pacing de subtitulos; um pedido de jogador deve enviar-lhe para o pacing de extração. Mudar codecs MP4 ou limitar mídias de bytes não retarda um metadados-somente loop.

Se o yt-dlp exibir `Sign in to confirm you’re not a bot`, siga o guia de verificação de bot. Um IP sinalizado pode ficar bloqueado por mais tempo que um limite temporário. Para um erro 403 no download de mídia, siga o guia específico de erros 403.

- [Inscrições de inspeção de bot](https://flashdata.dev/pt/docs/guides/yt-dlp-sign-in-not-a-bot/reference.md)
- [Apresentação de Mídia HTTP 403](https://flashdata.dev/pt/docs/guides/yt-dlp-403-forbidden/reference.md)

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

## Use o controle de taxa adequado


| Controle | Escopo | O que não resolve |
| --- | --- | --- |
| --sleep-requests 3 | Retardar entre os pedidos de extração dentro deste download. | Coordenação entre outros funcionários ou todas as chamadas API separadas na sua aplicação. |
| --sleep-subtitles 5 | Retardar antes de cada subtítulo de download. | Uma corda ainda requerendo cada língua disponível em muitos trabalhadores. |
| --sleep-interval 5 --max-sleep-interval 10 | Espere antes de baixar o vídeo. | Um loop usando download=False ou --skip-download para metadados apenas. |
| --concurrent-fragments 1 | A concorrência de fragmentos nativos dentro de um trabalho de mídia. | O número de processos separados yt-dlp. |
| --limit-rate 2M | Transmissão de banda de mídia. | Frequência de solicitação de busca, jogador ou transcript. |
| Uma quebra de saída compartilhada | Total de empregos ativos e solicitação brotar através de um único IP de saída. | Uma taxa IP já está limitada por inquilinos ou empregos não relacionados. |

**Coletar apenas traços selecionados, com 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"
```

Use uma única etiqueta de idioma, como en se o seu conjunto de dados só precisa dessa pista. en.* pode solicitar várias variantes.

Os números acima são as configurações de início para uma recuperação controlada, não publicações de quotas. Aumente o espaço quando a rejeição retorna. Recordar o IP de saída efetivo e o número de trabalhadores ao lado de erros para que um trabalhador recém-iniciado ou um proxy compartilhado não multiplique silenciosamente a taxa de solicitação.

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

## Exemplo de Python: tempo metadados-só trabalhos


Com download=False, os sonhos de download de mídia não são um programa de trabalho. Adicione um atraso entre as fontes e sleep_interval_requests dentro yt-dlp. Comece seqüentemente, pare de um fracasso e classifique o erro antes de decidir quando retire-o.

**Um trabalhador de metadados deliberadamente seqüencial**

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

Crie urls.txt com um URL de vídeo por linha. Este exemplo mínimo parou em qualquer erro de download; uma faixa de produção deve classificar falhas, IDs de ponto de verificação e evitar duplicar registros no resumo.

Não detectar cada falha do YouTube procurando por uma linha de mensagens de erro e dormindo sem fim. Mantenha os itens falhados com o seu erro e tentando contar. Um cooldown compartilhado pertence à saída IP ou sessão, enquanto um vídeo não disponível é um fracasso de nível de item. Outros trabalhadores devem respeitar o mesmo cooldown.

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

## Substituir uma saída que permanece limitada


Em uma conexão direta, isso significa um outro uso host/network egress. Com um proxy, significa uma saída diferente do proxy, não apenas uma endereço de gateway diferente. Parar os trabalhadores antigos antes de testar a substituição e manter as mesmas configurações de baixo carregamento.

**Um teste controlado através de uma saída de substituição**

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

Para um emprego de mídia, mantenha esta saída estável da extracção através do transferência; rota entre os trabalhos ou antes de uma nova retração. Uma piscina de proxy ajuda a distribuir o trabalho em massa apenas quando as saídas da piscina são usáveis e a taxa por saída é controlada. Se a substituição imediatamente colidir 429 também, inspeccione o uso compartilhado e a cola em vez de acelerar a rotação.

- [Exit-IP testes e sessões de estímulo](https://flashdata.dev/pt/docs/guides/yt-dlp-403-forbidden/reference.md#environment)

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

## Resumo sem repetição do trabalho concluído


1. Retire a operação exata que falha: metadados, página de pesquisa, track de tag ou fluxo de mídia.
2. Comece um trabalhador e observe vários itens. Restaura a concorrência gradualmente, com um limite por IP.
3. Reutilizar os IDs descobertos e metadados existentes em vez de repetir cada pesquisa e extração.
4. Mantenha as línguas solicitadas explicitamente e retire apenas as pistas perdidas.
5. Use retrasas limitadas com aumentos de espera e jitter na cova compartilhada. parar de retrair imediatamente quando a mesma saída é rejeitada novamente.

Manter os meios de comunicação separados e os Estados de notícias. Se o MP4 concluído, mas as capções tiveram 429, mantenha o arquivo e agendar uma reparação de nota. O reabastecimento dos meios adiciona carga e ainda não estabelece a integridade do texto. Um arquivo de mídia sozinho não é um registro de cobertura de notas.

- [DataSet Media e inventário de notas](https://flashdata.dev/pt/docs/guides/how-to-use-yt-dlp/reference.md#dataset)
- [Python trabalhadores e registros de conclusão](https://flashdata.dev/pt/docs/guides/yt-dlp-python-api/reference.md)
- [Avaliação 429 Guia](https://github.com/yt-dlp/yt-dlp/wiki/FAQ#http-error-429-too-many-requests-or-402-payment-required)
- [Guia de taxa de solicitação do YouTube](https://github.com/yt-dlp/yt-dlp/wiki/Extractors#this-content-isnt-available-try-again-later)
