权重需手动下载 DWPose 的 yolox_l.onnx、dw-ll_ucoco_384.onnx 和 MimicMotion_1-1.pth 并按目录放好,SVD 模型才会自动下载;显存不足时可设 PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:256 或减少帧数;Hugging Face 连不上可设 HF_ENDPOINT=https://hf-mirror.com。
MimicMotion
Tencent更新放缓用置信度感知的姿态引导,从单张参考图生成高质量人体动作视频,解决动作视频生成中姿态不准、画面抖动的问题。
High-Quality Human Motion Video Generation with Confidence-aware Pose Guidance
conda env create -f environment.yaml
conda activate mimicmotion
python inference.py --inference_config configs/test.yamlREADME 说明 72 帧模型需 16GB 显存(4060ti 可跑),4090 上约 20 分钟生成 35 秒演示视频;16 帧 U-Net 最低 8GB,但 VAE 解码需 16GB,可选择把 VAE 解码放到 CPU 上跑;官方在 Nvidia V100 上验证过。
腾讯开源的可控人体动作视频生成框架,用姿态引导让静态图按参考动作动起来
用置信度感知的姿态引导,从单张参考图生成高质量人体动作视频,解决动作视频生成中姿态不准、画面抖动的问题。
核心能力
- 用置信度感知的姿态引导保证时序平滑
- 基于姿态置信度的区域损失放大抑制图像畸变
- 渐进式潜变量融合支持生成任意长度视频
- 1.1 版权重把最大帧数从 16 扩到 72 帧
- 支持 576x1024 分辨率输出
容易踩的坑
暂无 release 数据(可能没有发版,或尚未同步)。
用户点评
登录用户的真实使用记录,可按版本和硬件筛选还没有人点评。第一个说出真实体验的人最有价值。
MimicMotion [ICML 2025]
Overview
In recent years, generative artificial intelligence has achieved significant advancements in the field of image generation, spawning a variety of applications. However, video generation still faces considerable challenges in various aspects such as controllability, video length, and richness of details, which hinder the application and popularization of this technology. In this work, we propose a controllable video generation framework, dubbed MimicMotion, which can generate high-quality videos of arbitrary length with any motion guidance. Comparing with previous methods, our approach has several highlights. Firstly, with confidence-aware pose guidance, temporal smoothness can be achieved so model robustness can be enhanced with large-scale training data. Secondly, regional loss amplification based on pose confidence significantly eases the distortion of image significantly. Lastly, for generating long smooth videos, a progressive latent fusion strategy is proposed. By this means, videos of arbitrary length can be generated with acceptable resource consumption. With extensive experiments and user studies, MimicMotion demonstrates significant improvements over previous approaches in multiple aspects.
News
[2025-05-03]: 🎉 Our paper is accepted by ICML 2025. Congratulations and many thanks to the co-authors![2024-07-08]: 🔥 A superior model checkpoint has been released as version 1.1. The maximum number of video frames has now been expanded from 16 to 72, significantly enhancing the video quality![2024-07-01]: Project page, code, technical report and a basic model checkpoint are released. A better checkpoint supporting higher quality video generation will be released very soon. Stay tuned!
Quickstart
For the initial released version of the model checkpoint, it supports generating videos with a maximum of 72 frames at a 576x1024 resolution. If you encounter insufficient memory issues, you can appropriately reduce the number of frames.
Environment setup
Recommend python 3+ with torch 2.x are validated with an Nvidia V100 GPU. Follow the command below to install all the dependencies of python:
conda env create -f environment.yaml
conda activate mimicmotion
Download weights
If you experience connection issues with Hugging Face, you can utilize the mirror endpoint by setting the environment variable: export HF_ENDPOINT=https://hf-mirror.com.
Please download weights manually as follows:
cd MimicMotions/
mkdir models
- Download DWPose pretrained model: dwpose
mkdir -p models/DWPose wget https://huggingface.co/yzd-v/DWPose/resolve/main/yolox_l.onnx?download=true -O models/DWPose/yolox_l.onnx wget https://huggingface.co/yzd-v/DWPose/resolve/main/dw-ll_ucoco_384.onnx?download=true -O models/DWPose/dw-ll_ucoco_384.onnx - Download the pre-trained checkpoint of MimicMotion from Huggingface
wget -P models/ https://huggingface.co/tencent/MimicMotion/resolve/main/MimicMotion_1-1.pth - The SVD model stabilityai/stable-video-diffusion-img2vid-xt-1-1 will be automatically downloaded.
Finally, all the weights should be organized in models as follows
models/
├── DWPose
│ ├── dw-ll_ucoco_384.onnx
│ └── yolox_l.onnx
└── MimicMotion_1-1.pth
Model inference
A sample configuration for testing is provided as test.yaml. You can also easily modify the various configurations according to your needs.
python inference.py --inference_config configs/test.yaml
Tips: if your GPU memory is limited, try set env PYTORCH_CUDA_ALLOC_CONF=max_split_size_mb:256.
VRAM requirement and Runtime
For the 35s demo video, the 72-frame model requires 16GB VRAM (4060ti) and finishes in 20 minutes on a 4090 GPU.
The minimum VRAM requirement for the 16-frame U-Net model is 8GB; however, the VAE decoder demands 16GB. You have the option to run the VAE decoder on CPU.
Citation
@inproceedings{zhang2025mimicmotion,
title={MimicMotion: High-Quality Human Motion Video Generation with Confidence-aware Pose Guidance},
author={Yuang Zhang and Jiaxi Gu and Li-Wen Wang and Han Wang and Junqi Cheng and Yuefeng Zhu and Fangyuan Zou},
booktitle={International Conference on Machine Learning},
year={2025}
}