用途:typed-ffmpeg 是一个现代 Python FFmpeg 封装库,强调类型安全、IDE 集成与全面的滤镜支持,适合在 Python 中构建转码、滤镜处理与媒体分析流程。
主要能力:零依赖(纯标准库);对 FFmpeg 滤镜提供详细类型与文档;支持 IDE 自动补全与类型检查;支持滤镜图可视化与序列化;集成 ffprobe 做媒体文件分析;支持输入/输出选项;支持部分求值以模块化构建滤镜链。
安装:pip install typed-ffmpeg;图形可视化:pip install 'typed-ffmpeg[graph]';兼容 ffmpeg-python:pip install typed-ffmpeg-compatible。需系统已安装 FFmpeg,要求 Python 3.10+。
用法:import ffmpeg 后可用链式 API,如 ffmpeg.input("input.mp4").output("output.mp4").run();输入可传 ss、t、r、s 等选项,输出可传 vcodec、acodec、crf、preset 等;用 .video/.audio 选择流,用 .hflip()、.scale()、.volume() 等应用滤镜;多输入可用 ffmpeg.filters.concat 或 overlay;用 ffmpeg.probe() 或 ffmpeg.probe_obj() 读取媒体信息;用 ffmpeg.compile(stream) 生成命令而不执行,用 stream.view() 可视化滤镜图。
适用场景:视频转码、提取音频、生成缩略图、画中画、拼接、批量滤镜处理及媒体信息检查。
限制:需本机安装 FFmpeg;部分滤镜参数需字符串表达式;流类型与滤镜顺序会影响结果;可视化需额外安装 graphviz。具体收费、平台与效果资料暂未提供。