FantasyTalking

amap_cvlab/FantasyTalking

Publisheramap_cvlab

Download access requirementsModelScope source

license: Apache License 2.0 FantasyTalking: Realistic Talking Portrait Generation via Coherent Motion Synthesis [](https://fantasy-amap.github.io/fantasy-talking/)

Video Generation

View all download instructions Mirror repository documentation and license ↗

Model details

模型介绍

中文整理

frameworks:

Pytorch

license: Apache License 2.0

tasks:

motion-generation

中文阅读

FantasyTalking: Realistic Talking Portrait Generation via Coherent Motion Synthesis

[](https://fantasy-amap.github.io/fantasy-talking/)

[](https://arxiv.org/abs/2504.04842)

[](https://huggingface.co/papers/2504.04842)

🔥 Latest News!!

2025年4月28日: 开源了音频条件下的推理代码和模型权重。

Quick start

🛠️安装和依赖

首先克隆git仓库：

安装依赖：

🧱模型下载

模型下载链接备注

------------- ------------------------------------------------------------------------------- -------------------------------

Wan2.1-I2V-14B-720P 🤗 Huggingface 🤖 ModelScope 基础模型

Wav2Vec 🤗 Huggingface 🤖 ModelScope 音频编码器

FantasyTalking model 🤗 Huggingface 🤖 ModelScope 我们的音频条件权重

使用huggingface-cli下载模型：

使用modelscope-cli下载模型：

🔑 推理

您可以通过提示控制角色的行为。提示和音频配置的推荐范围是[3-7]。

我们在此处提供了一个详细的表格。该模型在单个A100上进行了测试。(512x512，81帧)

torch dtype num persistent param in dit Speed Required VRAM

- - -

torch.bfloat16 None (unlimited) 15.5s/it 40G

torch.bfloat16 7*10**9 (7B) 32.8s/it 20G

torch.bfloat16 0 42.6s/it 5G

Gradio 示例

我们构建了一个Huggingface在线演示。

对于本地的gradio演示，您可以运行：

🧩 社区工作

我们❤️喜欢来自开源社区的贡献！如果你的工作改进了FantasyTalking，请告诉我们。

🔗Citation

If you find this repository useful, please consider giving a star ⭐ and citation

致谢

感谢Wan2.1、HunyuanVideo和DiffSynth-Studio开源他们的模型和代码，为该项目提供了宝贵的参考和支持。他们对开源社区的贡献真正值得赞赏。

优先采用原作者提供的中文模型卡片；仅有英文说明时由闲社AI翻译整理。重要参数、许可证和商用范围请以原文为准。

你将获得什么

完整仓库方式包含该固定版本中的权重、配置、分词器及说明文件；指定版本方式只下载所选文件或整组分片。多模态模型的投影文件、配置等依赖，请按作者说明配齐。

完整仓库可能包含多个权重格式，因此需要的磁盘空间可能大于单一格式的模型大小。下载文件不等于完成模型部署。

使用前须知

运行环境

运行模型需要的设备、工具与依赖，以原作者说明为准。

授权范围

是否允许商用、修改和分发，请查看模型许可证。

闲社提供资料与镜像下载方法，不代表已运行模型或完成安全审计。下载的代码应先检查，再执行。

Problem with the information or download?

Pinned version · Multiple download options

FantasyTalking model download

Download the full repository or choose a version or file.

Download tools · More than GGUF

Use the Hugging Face download tool to obtain amap_cvlab/FantasyTalking. Download Safetensors, GGUF, ONNX, configuration and other repository files. Downloading does not mean the tool can run this model.

Pinned-version file information is being completed. Existing downloads remain available, or load the file manifest below.

Choose a mirror or official source, your operating system and download scope below, then copy the command. Install the download tool first if needed.

Pinned version: 73ce915951c518a18b159254c664199430584441. Downloads files only; does not start the model.

Choose a download source

Pinned ModelScope version: 73ce915951c518a18b159254c664199430584441. Version identifiers can differ across sites. The alternative source was provided after checking weights and runtime configuration; this is not proof of a successful model run.

A checked, pinned ModelScope source is available for this model. Use the ModelScope download tool.

Choose what to download

Need just one GGUF precision? Load the file manifest and choose a version. Direct file links do not require Python; the command below can download multiple shards together.

Quantization / file

This reads the pinned version's file manifest; no model weights are downloaded.

Choose your operating system

For command-line downloads, follow these steps to get the full repository or selected files. Direct file links do not need these steps.

Open a terminal window

Create and open a folder for the model. In the folder's address bar, enter powershell and press Enter.

If Python is not installed, get it from the official Python website. In the terminal, enter python --version; continue when a version number appears.

First time? Install the download tool

Copy this command, paste it into the terminal, press Enter and wait for installation to finish.

python -m pip install --upgrade huggingface_hub

Already installed? Continue to step 3.

Run the download command

Select the button below, paste into the same terminal and press Enter. The tool downloads all files included in the current command.

Copying does not start a download. Paste and run the command on your device.

Where are the downloaded files?

Open the folder you chose. Look for the models folder. When progress stops and the terminal returns to its prompt without errors, check that all files are present. 'Copied' does not mean 'downloaded'.

No response or an error?

python not found: Install Python and reopen the terminal. On Windows, follow the installer's instructions to enable command-line access.

hf not found: Confirm that step 2 succeeded, then reopen the terminal. If needed, add Python's Scripts folder to your user PATH. Do not repeatedly download scripts.

Network interrupted: Stay in the same folder and run the same command again. The tool checks existing files.

Permission or disk error: Choose a writable folder with enough free space. Do not disable system security protection.

View the full download command

modelscope download --model "amap_cvlab/FantasyTalking" --revision "73ce915951c518a18b159254c664199430584441" --local_dir "./models/amap_cvlab--FantasyTalking--ms-73ce915951c5"

Files transfer directly from the source you choose, not through Xianshe servers.

The version is pinned. Repeating the same command checks existing files. Change the source manually if it is slow or unavailable.

Public models do not require submitting keys to Xianshe. Restricted models still require the author's authorization. On Linux / macOS, use python3 instead of python when appropriate.