yt-dlp设置noplaylist无效 如何仅提取播放列表单个视频信息

使用Python编写yt-dlp调用代码如下：

import yt_dlp

YDL_OPTIONS = {
    'format': 'bestaudio*',
    'noplaylist': True,
}

with yt_dlp.YoutubeDL(YDL_OPTIONS) as ydl:
    info = ydl.extract_info(url, download=False)

当传入的URL直接指向YouTube播放列表时，配置中的noplaylist参数未生效，程序会依次遍历拉取播放列表内所有视频的信息，运行输出日志如下：

[youtube:tab] PLlrATfBNZ98dudnM48yfGUldqGD0S4FFb: Downloading webpage
[youtube:tab] PLlrATfBNZ98dudnM48yfGUldqGD0S4FFb: Downloading API JSON with unavailable videos
[download] Downloading playlist: C++
[youtube:tab] playlist C++: Downloading 100 videos
[download] Downloading video 1 of 100
[youtube] 18c3MTX0PK0: Downloading webpage
[youtube] 18c3MTX0PK0: Downloading android player API JSON
[download] Downloading video 2 of 100
[youtube] 1OsGXuNA5cc: Downloading webpage
[youtube] 1OsGXuNA5cc: Downloading android player API JSON
[download] Downloading video 3 of 100
[youtube] 1E_kBSka_ec: Downloading webpage
[youtube] 1E_kBSka_ec: Downloading android player API JSON
...

需求为找到对应的配置参数或调用方法，让yt-dlp仅提取整个播放列表中单个视频（例如第一个视频）的信息。

首先明确noplaylist参数的生效逻辑：该参数仅在URL同时包含单个视频ID与播放列表ID时触发（例如带list参数的单个视频观看页链接），会自动忽略播放列表部分，仅处理当前视频；如果传入的URL本身是纯播放列表链接，该参数不会生效。
要实现仅提取播放列表内指定单个视频的信息，有两种成熟方案：

• 方案1：通过playlist_items参数指定提取范围
  该参数接收字符串格式的条目序号规则，yt-dlp只会提取匹配规则的播放列表条目，不需要额外二次请求。如果只需要第一个视频，直接将参数值设为'1'即可，配置示例：

  import yt_dlp
  
  YDL_OPTIONS = {
      'format': 'bestaudio*',
      'noplaylist': True,
      'playlist_items': '1',  # 仅提取播放列表第1个条目
  }
  
  with yt_dlp.YoutubeDL(YDL_OPTIONS) as ydl:
      info = ydl.extract_info(url, download=False)
  

  如果需要提取其他单个条目，直接传入对应序号字符串即可，例如取第5个视频就写'5'；需要提取多个条目可以传入范围规则，例如'1,3,6-10'代表提取第1、3、6到10个条目。
• 方案2：浅解析播放列表后单独请求目标视频信息
  如果需要先判断URL类型、或后续要对播放列表条目做自定义筛选，可以先开启extract_flat参数做浅解析。该模式下yt-dlp只会拉取播放列表的基础结构和条目的ID、标题等基础信息，不会逐个请求每个视频的完整接口，解析速度极快。拿到目标视频ID后，再单独构造视频链接请求完整信息即可，示例代码：

  import yt_dlp
  
  YDL_OPTIONS = {
      'format': 'bestaudio*',
      'noplaylist': True,
      'extract_flat': True,  # 开启浅解析，不拉取单个视频的完整信息
  }
  
  with yt_dlp.YoutubeDL(YDL_OPTIONS) as ydl:
      playlist_info = ydl.extract_info(url, download=False)
      # 取第一个视频的ID
      first_video_id = playlist_info['entries'][0]['id']
      first_video_url = f'https://www.youtube.com/watch?v={first_video_id}'
      # 单独提取第一个视频的完整信息
      first_video_info = ydl.extract_info(first_video_url, download=False)
  

内容的提问来源于stack exchange，提问作者sweetbrulee