如何在ffmpeg-python中正确使用afir滤镜实现音频变速加混响

你遇到的核心问题是afir滤镜在ffmpeg-python中的参数传递格式错误——ffmpeg-python要求将命令行的键值对参数以关键字参数形式传入，而非命令行的冒号拼接格式。以下是完整的可运行实现方案：

完整代码示例 #

假设你已准备好混响所需的脉冲响应（IR）文件（比如reverb_ir.wav），代码如下：

import ffmpeg

# 读取输入音频
audio = ffmpeg.input(r'test_files\Gorillaz - Rhinestone Eyes.mp3').audio

# 第一步：用rubberband实现音频减速（tempo=0.8），保留可选的变调参数
audio = audio.filter('rubberband', tempo=0.8, pitch=0.8, pitchq='quality')

# 第二步：调用afir滤镜添加混响，指定脉冲响应文件及干湿比
# ir：脉冲响应文件路径；dry：干声比例；wet：混响声比例（范围0-1）
audio = audio.filter('afir', ir=r'reverb_ir.wav', dry=0.6, wet=0.4)

# 输出配置：指定格式、比特率，开启覆盖已有文件
output = ffmpeg.output(audio, r'final\test.mp3', format='mp3', audio_bitrate=320_000)
ffmpeg.run(output, overwrite_output=True)

参数说明与错误排查 #

• afir核心参数：ir是必填项，必须指向一个有效的脉冲响应文件，对应命令行中的afir=ir=xxx.wav；dry和wet用于调整干湿声平衡，可根据需求自定义数值。
• 参数兼容性：如果你的命令行afir还有其他参数（如length、grain），直接以关键字参数形式添加到filter方法中即可，参数名与ffmpeg官方文档完全一致。
• 路径问题：若报错找不到IR文件，建议使用绝对路径避免相对路径解析错误；若参数无效，检查参数名拼写是否与ffmpeg官方afir参数匹配。

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