1. v2

• https://zulko.github.io/moviepy/

1.1. 安装

• pip install moviepy

You do need to worry about ffplay if you plan on using video/audio previewing. For these cases, make sure to have ffplay installed (it can usually be found alongside ffmpeg) and make sure it is accessible to Python, or define a custom path (see below).

还需要安装ffmpeg，ffplay，用来进行视频预览。

FFmpeg 全称：Fast Forward MPEG Audio/Video Encoder 简介： FFmpeg 是一个开源的跨平台多媒体处理工具，用于视频和音频的录制、转换、流处理等。它支持几乎所有主流的多媒体格式（包括编解码器），并提供丰富的滤镜、转码参数和协议适配功能。

FFplay 全称：Fast Forward Player 简介： FFplay 是 FFmpeg 项目的一部分，是一个基于命令行的多媒体播放器。它基于 FFmpeg 的解码库构建，主要用于测试音视频流、查看媒体元数据或调试播放问题。

将所有视频、图片、文字抽象为一个clip，然后进行操作，最后合成。

from moviepy import (
    VideoClip,
    VideoFileClip,
    ImageSequenceClip,
    ImageClip,
    TextClip,
    ColorClip,
    AudioFileClip,
    AudioClip,
)

可以用clip = ColorClip(size=(460, 380), color=black) ，ColorClip生成背景颜色

1.2. 变更

目前很多的LLM是基于v1版本训练的，不是v2版本的，所以生成的代码在很多时候不使用。目前的改变好下：

• 不再支持python2.0, 支持python3.7以上版本。
• .set_ 方法改为 .with_
• Clip.fx 方法改为 with_effects()
• clip.resize is now clip.resized
• clip.crop is now clip.cropped
• clip.rotate is now clip.rotated

关闭一个clip时需要注意：

• 当所有使用该clip的对象都关闭时，该clip才会被关闭。
• 即使是一个CompositeVideoClip，仍然需要手工的关闭这个CompositeVideoClip关联的所有clip。

1.3. 使用流程

如果只是做一个简单视频，通常流程是：

1. 准备图片、视频片段、音频和字幕文本。
2. 把它们分别转成不同类型的 clip。
3. 对 clip 做时长、位置、缩放、透明度等处理。
4. 用 CompositeVideoClip 或 concatenate 组合。
5. 最后导出成 mp4。

1.4. 适用场景

• 自动生成短视频
• 图片 + 配音 + 字幕合成
• 简单片头片尾拼接
• 批量媒体处理脚本

1.5. 注意点

• 真正的编解码能力底层还是依赖 FFmpeg。
• 生成速度通常受分辨率、帧率、滤镜和编码参数影响很大。
• clip 对象较多时要及时关闭，避免句柄和内存泄漏。