Idol

Idol

在 Gradio 演示里把一张图片变成由高斯点云组成的 3D 物体，作为 Hugging Face Space 运行。适合想试用单图转 3D 的艺术家和研究者。

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

简介

它是什么：Idol 是 Speridlabs 做的演示，能用一张图片生成 3D 物体。3D 结果由高斯点云组成。它以 Gradio 应用的形式运行在 Hugging Face Spaces 上。

适合谁：它适合想看一张图片能变成什么样的 3D 的人，也适合想看这类演示怎么搭起来的人。

Industry | Who uses it | How they use it | Example
3D 艺术和游戏 | 艺术家和原型制作者 | 把一张参考图变成 3D 物体 | 试着把角色草图变成 3D 人物
计算机视觉 | 研究者 | 用示例图片和保存的设置测试单图转 3D | 在同类图片上对比两个预设
软件 | 应用开发者 | 阅读 Space 的文件，看 Gradio 前端怎么包装模型 | 把 Space 的结构用到自己的演示里

如果你需要能直接放进游戏引擎的完整网格，可以跳过它，因为这个演示说自己的输出是高斯点云。

用在哪里：Space 通过 Gradio 界面在浏览器里运行。你也可以复制这个 Space，自己运行一份。

Use case | Who | What they get back
一张图转 3D | 艺术家 | 一个由高斯点云组成的 3D 物体
试用示例 | 新手 | 每张示例图片按它保存的设置运行

如何设置：来源里没有给出安装命令，所以本页没有代码块。Space 需要一个 Hugging Face 令牌来加载两个图像编码器。

• 一个有权访问 facebook 组织下 dinov3-vith16plus-pretrain-lvd1689m 编码器的 Hugging Face 账号。
• 同一个账号还要有权访问 black-forest-labs 的 FLUX.2-dev 编码器。
• 你复制的 Space 上，要有一个名为 HF_TOKEN 的密钥。

1. 在你的 Hugging Face 账号上申请这两个图像编码器的访问权限。
2. 为该账号创建一个访问令牌。
3. 把令牌作为名为 HF_TOKEN 的密钥添加到 Space。
4. 保存密钥后，打开这个 Space。

如何使用：先从一张示例图片开始。每张示例都列出了它运行时用的设置，所以在你改动任何东西之前，就能看到这个演示做了什么。

Tool | What it does
app.py | Gradio 演示的用户界面
model.py | 生成 3D 物体的模型
examples/presets.json | 存放示例图片和每张图片运行时用的设置

注意事项：

• 如果 HF_TOKEN 所属的账号没有同时访问两个编码器的权限，Space 就无法加载它们。
• 来源没有给出图片大小、运行时间或导出格式的限制。
• 来源没有说明模型内部怎么工作。需要了解的话，请读 model.py。
• 许可证是 Apache 2.0。

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

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

链接

• Space：https://huggingface.co/spaces/speridlabs/idol
• 文件：https://huggingface.co/spaces/speridlabs/idol/tree/main

试用

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