基础用法
画质与音质
控制下载的视频画质和音频质量
画质控制策略
按分辨率
# 不超过 1080p 的最佳画质
yt-dlp -f "bestvideo[height<=1080]+bestaudio" "URL"
# 至少 720p
yt-dlp -f "bestvideo[height>=720]+bestaudio" "URL"
# 精确 1080p
yt-dlp -f "bestvideo[height=1080]+bestaudio" "URL"import yt_dlp
ydl_opts = {
'format': 'bestvideo[height<=1080]+bestaudio',
}
with yt_dlp.YoutubeDL(ydl_opts) as ydl:
ydl.download(["URL"])按文件大小
# 文件不超过 100MB
yt-dlp -f "best[filesize<100M]" "URL"
# 预估文件不超过 50MB
yt-dlp -f "best[filesize_approx<50M]" "URL"import yt_dlp
ydl_opts = {
'format': 'best[filesize<100M]',
}
with yt_dlp.YoutubeDL(ydl_opts) as ydl:
ydl.download(["URL"])格式排序（-S）
-S 是更灵活的画质控制方式，可以设定多维度优先级：
# 优先 1080p，其次 codec 质量
yt-dlp -S "res:1080,codec" "URL"
# 优先 H.264 编码（兼容性好），其次分辨率
yt-dlp -S "codec:h264,res" "URL"
# 优先 mp4 容器，其次分辨率，限制 1080p 以下
yt-dlp -S "ext:mp4:m4a,res:1080" "URL"
# 优先小文件
yt-dlp -S "+size" "URL"| 排序 key | 说明 |
|---|---|
res | 分辨率（res:1080 表示偏好 1080p） |
codec | 编解码器质量 |
ext | 容器格式偏好 |
size | 文件大小（+size 越小越好） |
br | 比特率 |
fps | 帧率 |
hdr | HDR 偏好 |
音质控制
音频比特率
# 最高音质
yt-dlp -x --audio-quality 0 "URL"
# 中等音质（节省空间）
yt-dlp -x --audio-quality 5 "URL"
# 指定比特率
yt-dlp -x --audio-format mp3 --audio-quality 320K "URL"
yt-dlp -x --audio-format mp3 --audio-quality 192K "URL"
yt-dlp -x --audio-format mp3 --audio-quality 128K "URL"import yt_dlp
# 最高音质 m4a
ydl_opts = {
'format': 'bestaudio/best',
'postprocessors': [{
'key': 'FFmpegExtractAudio',
'preferredcodec': 'm4a',
'preferredquality': '0', # 最高
}],
}
# 指定 320k mp3
ydl_opts_320k = {
'format': 'bestaudio/best',
'postprocessors': [{
'key': 'FFmpegExtractAudio',
'preferredcodec': 'mp3',
'preferredquality': '320',
}],
}音频质量等级
--audio-quality 值 | MP3 大约比特率 | 适用场景 |
|---|---|---|
| 0 | ~320kbps | 高保真，音乐收藏 |
| 2 | ~192kbps | 一般音乐 |
| 5 | ~128kbps | 语音/播客 |
| 9 | ~65kbps | 极低质量预览 |
对于 m4a (AAC) 和 opus 格式，quality 0 通常直接保留源音频的比特率，不做额外转码，是最佳选择。
推荐配置
| 场景 | 推荐格式字符串 |
|---|---|
| 日常观看 | bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a] |
| 带宽有限 | bestvideo[height<=720]+bestaudio |
| 音乐收藏 | bestaudio + FFmpegExtractAudio m4a quality 0 |
| 4K 归档 | bestvideo+bestaudio |
| 手机播放 | -S "ext:mp4:m4a,res:720" |