YM MediatoolToolkit

概述

一个高性能的流式视频处理 Skill，无需下载完整视频文件即可完成：

• 视频压缩 - 保持清晰度，体积可压缩至 1/10
• 封面提取 - 任意时间点或帧号提取封面
• 音频提取 - 转成 MP3 / WAV / AAC / M4A 格式

所有操作均采用流式处理，边下载边处理，大幅节省时间和磁盘空间。

安全特性

URL 验证 (SSRF/LFI 防护)

utils.validate_video_url() 在所有入口点和子进程调用前执行多层验证：

DNS 错误策略：如果 DNS 解析失败（超时/网络错误），验证将拒绝请求（fail-close），而非放行。这是与早期版本的区别——之前版本在 DNS 失败时会发出警告并允许通过。

输出路径防护

utils.sanitize_output_path() 对所有用户提供的 output_path、save_path、output_dir 执行检查：

路径清理在所有入口点执行：

• run.py — handle_compress、handle_thumbnail、handle_audio、handle_audio_batch
• audio_extractor.py — extract_audio_streaming、extract_audio_batch
• frame_extractor.py — extract_thumbnail_from_url

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 通过命令行使用

提供 JSON 参数：

# 压缩视频
python run.py -a compress -i '{"video_url": "https://example.com/video.mp4", "target_ratio": 0.1}'

# 提取封面（第 0 秒）
python run.py -a thumbnail -i '{"video_url": "https://example.com/video.mp4"}'

# 提取音频
python run.py -a audio -i '{"video_url": "https://example.com/video.mp4", "format": "mp3"}'

3. 通过配置文件

python run.py -i params.json

4. 启动 HTTP 服务

# 启动 API 服务
python run.py --serve

# 默认监听 127.0.0.1:8080（仅本地访问）

HTTP 模式需要 Flask：

pip install flask flask-cors

API 参考

所有端点接收 JSON body，响应 JSON。

POST /skill/compress

流式压缩视频。

请求参数：

响应示例：

{
  "status": "success",
  "output_path": "compressed_video.mp4",
  "original_size_mb": 150.5,
  "new_size_mb": 12.3,
  "ratio": 0.082,
  "crf_used": 24,
  "streaming": true
}

POST /skill/thumbnail

从视频提取封面。

请求参数：

响应示例：