🌐 Project Page | 📜 Arxiv | 🤗 Models |

DreamID-V: Bridging the Image-to-Video Gap for High-Fidelity Face Swapping via Diffusion Transformer
Xu Guo ^* , Fulong Ye ^* , Xinghui Li ^*, Pengqi Tu, Pengze Zhang, Qichao Sun, Songtao Zhao ^†, Xiangwang Hou ^† Qian He
^* Equal contribution, ^† Corresponding author
Tsinghua University | Intelligent Creation Team, ByteDance

Models	Download Link	Notes
DreamID-V	🤗 Huggingface	Supports 480P & 720P
Wan-2.1	🤗 Huggingface	VAE & Text encoder

Install dependencies:

# Ensure torch >= 2.4.0
pip install -r requirements.txt

• Single-GPU inference

python generate_dreamidv.py \
    --size 832*480 \
    --ckpt_dir wan2.1-1.3B path \
    --dreamidv_ckpt dreamidv.pth path  \
    --sample_steps 50 \
    --base_seed 42

• Multi-GPU inference using FSDP + xDiT USP

pip install "xfuser>=0.4.1"
torchrun --nproc_per_node=2 generate_dreamidv.py \
    --size 832*480 \
    --ckpt_dir wan2.1-1.3B path \
    --dreamidv_ckpt dreamidv.pth path  \
    --sample_steps 50 \
    --dit_fsdp \
    --t5_fsdp \
    --ulysses_size 2 \
    --ring_size 1 \
    --base_seed 42

Our work builds upon and is greatly inspired by several outstanding open-source projects, including Wan2.1, Phantom, OpenHumanVid, Follow-Your-Emoji. We sincerely thank the authors and contributors of these projects for generously sharing their excellent codes and ideas.

If you have any comments or questions regarding this open-source project, please open a new issue or contact Xu Guo.

If you find our work helpful, please consider citing our paper and leaving valuable stars

@misc{guo2026dreamidvbridgingimagetovideogaphighfidelity,
      title={DreamID-V:Bridging the Image-to-Video Gap for High-Fidelity Face Swapping via Diffusion Transformer}, 
      author={Xu Guo and Fulong Ye and Xinghui Li and Pengqi Tu and Pengze Zhang and Qichao Sun and Songtao Zhao and Xiangwang Hou and Qian He},
      year={2026},
      eprint={2601.01425},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2601.01425}, 
}