Idol Turbo

Idol Turbo

把一张图片变成 3D 物体，比 Idol 快约 12x，用的是只需 6 步而不是 50 步的蒸馏版本。适合想快速得到图片转 3D 结果的人。

由 akhaliq 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：Idol Turbo 是一个 Gradio 演示，能从一张图片生成 3D 物体。它是 speridlabs/idol 的蒸馏版本，只需 6 步而不是 50 步，也不需要引导环节，网络评估次数因此减少到原来的 1/16.7。

适合谁：它适合 3D 艺术家、游戏开发者和研究者，想要快速得到图片转 3D 的结果，也适合想把蒸馏模型和原版放在一起试用的人。

行业 | 谁在用 | 怎么用 | 例子
游戏开发 | 独立开发者 | 把单个物体的图片变成 3D 草稿 | 测试一张道具图片，查看 3D 物体
设计与 3D 艺术 | 艺术家 | 从参考图快速得到 3D 起点 | 连续试几张图片，比较各个草稿
AI 研究 | 研究者 | 把少步数模型和原版 Idol 做对比 | 在这里和原版 Space 里各运行同一张图片

如果你需要原版模型完整 50 步的输出，可以跳过它。

用在哪里：

• 网页浏览器，打开 Hugging Face 上这个 Space 的页面
• 文件的本地副本，在 Windows、macOS 或 Linux 上用 Python 3.12 运行
• 如果你要复制它，用你自己的 Space，并把硬件设为 ZeroGPU

用途 | 适合谁 | 能得到什么
快速 3D 草稿 | 艺术家和开发者 | 一张图片生成的 3D 物体，步数少得多
模型对比 | 研究者 | 看到 6 步权重与原版的差别
自己的副本 | 开发者 | 带有该演示界面和权重的自己的 Space

如何设置：

• 一个网页浏览器，在线页面只需要它
• Python 3.12，本地副本才需要
• requirements.txt 里列出的 Python 包
• 一个设为 HF_TOKEN 密钥的 Hugging Face 令牌，所属账号要能使用 black-forest-labs/FLUX.2-dev，VAE 编码器来自它

1. 在 Hugging Face 上打开这个 Space 的页面，就能在线使用，不需要安装任何东西。
2. 想要本地副本，先安装 Hugging Face hub 包，再下载 Space 的文件。
3. 进入下载好的文件夹。
4. 安装 Gradio 5.49.1，再安装 requirements.txt 里的包。
5. 用 python app.py 启动应用。

pip install -U huggingface_hub
hf download akhaliq/idol-turbo --repo-type space --local-dir idol-turbo
cd idol-turbo
pip install gradio==5.49.1
pip install -r requirements.txt
python app.py

如何使用：打开页面，或者打开你本地副本启动的页面，给它一张图片。应用会从中生成 3D 物体。页面布局来自 Speri Labs 的原版 Idol 演示。

示例：给应用一张单个物体的图片，比如一把椅子。它运行 6 步模型，在页面里返回这个物体的 3D 版本。

新手与专家：先打开 Space 页面，试一张单个物体的图片。不需要安装任何东西，你会在同一个页面里看到 3D 结果。

权重是用 phase-LoRA 方法在 93 张单个物体的图片上蒸馏出来的，引导已经内置其中，所以 6 个无引导步骤可以代替 50 个有引导步骤。仓库里有 app.py、model.py、turbo.py 和一个 idol 包。DINOv3 从一个核对过数值的社区镜像加载，所以不需要 Meta 的门禁审批。

你给应用一张图片
6 步的 Idol Turbo 权重处理它
VAE 编码器和 DINOv3 提供特征
Gradio 在页面里显示 3D 物体

注意事项：模型是在单物体图片上蒸馏的，所以单个物体是最稳妥的输入。在线版本需要 ZeroGPU 硬件。

• License: Apache 2.0
• Cost to run: 需要一个存为 HF_TOKEN 的 Hugging Face 令牌，所属账号要能使用 black-forest-labs/FLUX.2-dev，在线版本还需要 ZeroGPU 硬件
• Data it reaches: 你给它的图片，以及从 Hugging Face 加载的模型，包括 akhaliq/idol-turbo 和 ZhengPeng7/BiRefNet

Hugging Face 上的数据（2026年11月13日）

• 点赞：10
• 构建方式：gradio
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/akhaliq/idol-turbo
• 文件：https://huggingface.co/spaces/akhaliq/idol-turbo/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。