Idol SDK教程:一张图变3D高斯物体,7.2GB显存2秒内出百万高斯

📌 项目日期:2026年11月 | 数据来源:GitHub官方仓库 | 星数:505+

📋 项目简介

Idol(Sperid Labs)把"单图→3D物体"压到消费级硬件能跑的水平:给一张渲染图、AI生成图或照片,它自动去背景(BiRefNet)→框住物体→生成3D高斯——最多 1,048,576 个高斯点,连照片没拍到的侧面都补出来。7.2GB显存、2秒内出结果,HuggingFace Demo带93个现成例子。

图生3D赛道的场景版是 DeepOpen 3D Webs(可漫游场景)与 Fable51 Worlds(代码生成世界);Idol专注单物体高斯化,适合电商、资产库快速量产。

🔧 模型规格

部件规格
输出3DGS:32,768 ~ 1,048,576高斯(默认262,144),标准.ply
骨干DiT 370M;图像条件 DINOv3 ViT-H+ 与 FLUX.2 VAE;解码器288M
前处理BiRefNet背景移除
采样Euler 50步,CFG 3.0,time shift 3.0
硬件消费级GPU:7.2GB显存,<2秒生成

📦 安装

pip install -e .              # Python 3.10+, PyTorch 2.5+
pip install -e ".[demo]"      # + Gradio本地Demo

# 权重首次使用时从HuggingFace拉取(需申请访问facebook系权重)
# 在线Demo:huggingface.co/spaces/speridlabs/idol

✅ 使用建议

📚 常见问题

Idol SDK是什么?

Sperid Labs的单图转3D高斯物体推理SDK:给一张渲染图、生成图或照片,自动去背景、框住物体、生成最多1,048,576个高斯——包括照片没拍到的侧面。

硬件要求?

消费级GPU即可:7.2GB显存,2秒内可完成生成;Python 3.10+与PyTorch 2.5+。

模型规格是什么?

DiT 370M参数,图像条件用DINOv3 ViT-H+与FLUX.2 VAE,解码器288M,BiRefNet去背景,Euler采样50步(CFG 3.0);输出标准3DGS .ply(默认262,144高斯)。