/video_edit

name: video_edit
description: 音视频剪辑工具箱。包含视频剪辑截取、音频剪辑截取、视频画面裁剪、视频拼接合并、音频拼接合并、视频合成/替换音频。当用户提到音视频剪辑、裁剪视频、合并视频、音频剪辑、视频配音时使用。

video_edit Skill

> 音视频剪辑功能集（截取、裁剪、拼接、配音/音轨替换）

功能描述

本 Skill 将所有音视频剪辑相关功能合并为一个统一的 API 模块，包含以下 6 个核心剪辑功能：

1. `cut_video`: 截取视频指定时间段片段 2. `cut_audio`: 截取音频指定时间段片段 3. `crop_video`: 裁剪视频画面的坐标区域与尺寸 4. `concat_videos`: 多个视频文件顺序拼接合并 5. `concat_audios`: 多个音频文件顺序拼接合并 6. `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_video`
• `office.api.video.cut_audio`
• `office.api.video.crop_video`
• `office.api.video.concat_videos`
• `office.api.video.concat_audios`
• `office.api.video.add_audio_to_video`