Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Guias

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.

Nesta página

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
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
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.

Encontre a solicitação sendo taxa limitada

Trabalho falhadoPor que pode gerar muitas solicitaçõesPrimeira redução
Video metadados / pedidos de jogadorUma 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 enumerationOs 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çãoCada 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 / FragmentosVí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.

Use o controle de taxa adequado

ControleEscopoO que não resolve
--sleep-requests 3Retardar 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 5Retardar 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 10Espere antes de baixar o vídeo.Um loop usando download=False ou --skip-download para metadados apenas.
--concurrent-fragments 1A concorrência de fragmentos nativos dentro de um trabalho de mídia.O número de processos separados yt-dlp.
--limit-rate 2MTransmissão de banda de mídia.Frequência de solicitação de busca, jogador ou transcript.
Uma quebra de saída compartilhadaTotal 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
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.

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
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.

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
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.

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.