video_edit Skill
音视频剪辑功能集（截取、裁剪、拼接、配音/音轨替换）
功能描述
本 Skill 将所有音视频剪辑相关功能合并为一个统一的 API 模块，包含以下 6 个核心剪辑功能：
cut_video: 截取视频指定时间段片段cut_audio: 截取音频指定时间段片段crop_video: 裁剪视频画面的坐标区域与尺寸concat_videos: 多个视频文件顺序拼接合并concat_audios: 多个音频文件顺序拼接合并add_audio_to_video: 视频合成/替换背景音乐或音频
所属分类
office/skills/video/video_edit/
调用方式
from skills.video.video_edit import (
cut_video,
cut_audio,
crop_video,
concat_videos,
concat_audios,
add_audio_to_video,
)
或从 skills.video 模块导入：
from skills.video import video_edit
video_edit.cut_video(video_path='./test.mp4', start_time='00:00:10', end_time='00:00:30')
功能与参数说明
1. 视频截取 cut_video
| 参数 |
类型 |
必填 |
默认值 |
说明 |
video_path |
str |
是 |
- |
视频文件路径 |
start_time |
float/str |
否 |
0 |
开始时间（秒数或格式如 '00:01:10'） |
end_time |
float/str |
否 |
None |
结束时间（秒数或格式如 '00:02:30'，默认结尾） |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
None |
输出文件名（默认原名后加 _cut） |
2. 音频截取 cut_audio
| 参数 |
类型 |
必填 |
默认值 |
说明 |
audio_path |
str |
是 |
- |
音频文件路径 |
start_time |
float/str |
否 |
0 |
开始时间（秒数或格式如 '00:00:05'） |
end_time |
float/str |
否 |
None |
结束时间 |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
None |
输出文件名 |
3. 画面裁剪 crop_video
| 参数 |
类型 |
必填 |
默认值 |
说明 |
video_path |
str |
是 |
- |
视频文件路径 |
x1 |
int |
否 |
0 |
左上角 x 坐标 |
y1 |
int |
否 |
0 |
左上角 y 坐标 |
x2 |
int |
否 |
None |
右下角 x 坐标 |
y2 |
int |
否 |
None |
右下角 y 坐标 |
width |
int |
否 |
None |
裁剪宽度（可代替 x2） |
height |
int |
否 |
None |
裁剪高度（可代替 y2） |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
None |
输出文件名 |
4. 视频拼接 concat_videos
| 参数 |
类型 |
必填 |
默认值 |
说明 |
video_list |
list[str] |
是 |
- |
视频路径列表 |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
'concat_video.mp4' |
输出文件名 |
5. 音频拼接 concat_audios
| 参数 |
类型 |
必填 |
默认值 |
说明 |
audio_list |
list[str] |
是 |
- |
音频路径列表 |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
'concat_audio.mp3' |
输出文件名 |
6. 合成音频/配音 add_audio_to_video
| 参数 |
类型 |
必填 |
默认值 |
说明 |
video_path |
str |
是 |
- |
视频文件路径 |
audio_path |
str |
是 |
- |
音频文件路径 |
output_path |
str |
否 |
'./' |
输出目录 |
output_name |
str |
否 |
None |
输出文件名 |
使用示例
from skills.video import video_edit
# 视频截取
video_edit.cut_video(video_path='./input.mp4', start_time=0, end_time=10)
# 视频合成音频
video_edit.add_audio_to_video(video_path='./input.mp4', audio_path='./music.mp3')
原始函数
office.api.video.cut_videooffice.api.video.cut_audiooffice.api.video.crop_videooffice.api.video.concat_videosoffice.api.video.concat_audiosoffice.api.video.add_audio_to_video
coderwanfeng