X-Fun-Videos-Demo

# X-Fun-Videos-Demo ## 目录 - [数据集简介](#数据集简介) - [数据集结构](#数据集结构) - [数据说明](#数据说明) - [数据处理脚本](#数据处理脚本) - [使用方法](#使用方法) - [注意事项](#注意事项) - [相关项目](#相关项目) ## 数据集简介 这是一个用于 **VideoX-Fun** 项目的视频训练演示数据集，包含16个训练视频，适用于视频生成模型的训练和测试。 ## 数据集结构 ``` X-Fun-Videos-Demo/ ├── train/ # 训练视频目录 │ ├── 00000000.mp4 # 训练视频 (832x480) │ ├── 00000001.mp4 │ └── ... (共16个视频) ├── metadata.json # 数据集信息（基础版） ├── metadata_add_width_height.json # 数据集信息（包含宽高信息） ├── process_json_add_width_and_height.py # 为元数据添加视频宽高信息 ├── .gitattributes # Git LFS 配置文件 └── README.md # 本文件 ``` ## 数据说明 ### 视频信息 - **数量**: 16个训练视频 - **格式**: MP4 - **分辨率**: 832 x 480 (宽 x 高) - **内容**: 人物短视频，包含详细的动态标签描述 ### 标签描述 所有视频均使用统一的标签格式，包含以下特征： - 人物外貌特征（发型、服装、配饰） - 动作描述（头部转动、表情变化、手势） - 场景环境（背景、光线、氛围） - 动态细节（头发飘动、衣物摆动、光影变化） ### 元数据文件 #### metadata.json 基础版本的元数据文件，包含： - `file_path`: 视频文件路径 - `text`: 视频标签描述 #### metadata_add_width_height.json 增强版本的元数据文件，额外包含： - `height`: 视频高度（480） - `width`: 视频宽度（832） ## 数据处理脚本 本数据集提供一个 Python 脚本，用于数据预处理。 ### process_json_add_width_and_height.py 读取视频文件的分辨率，在元数据 JSON 中添加 `width` 和 `height` 字段。该脚本同时支持图片和视频格式。 ```bash python datasets/X-Fun-Videos-Demo/process_json_add_width_and_height.py \ --input_file datasets/X-Fun-Videos-Demo/metadata.json \ --output_file datasets/X-Fun-Videos-Demo/metadata_add_width_height.json \ --base_dir datasets/X-Fun-Videos-Demo/ \ --num_processes 4 ``` ## 使用方法 克隆数据集到VideoX-Fun的datasets文件夹。 ```bash modelscope download --dataset PAI/X-Fun-Videos-Demo --local_dir ./datasets/X-Fun-Videos-Demo ``` 在 VideoX-Fun 的配置文件中指定数据集路径： ```bash export DATASET_NAME="datasets/X-Fun-Videos-Demo" export DATASET_META_NAME="datasets/X-Fun-Videos-Demo/metadata_add_width_height.json" NCCL_DEBUG=INFO ``` ## 注意事项 - 本数据集仅用于演示和测试目的 - 推荐使用 `metadata_add_width_height.json` 以获取完整的视频尺寸信息 - 视频处理依赖 `opencv-python` 库，请确保已安装 ## 相关项目 - [VideoX-Fun-Wan2.2](https://github.com/your-org/VideoX-Fun-Wan2.2)