🎨 AI 3D 模型生成器

一个基于火山引擎AI的3D模型生成工具，支持从图片到3D模型的快速转换。

✨ 功能特点

• 🖼️ 图片转3D - 上传任意图片，AI自动生成3D模型
• 🤖 多模型支持 - 集成火山引擎多款AI模型（Seed3D 2.0、Hyper3D、Hitem3D 2.0）
• 💾 多格式导出 - 支持GLB、OBJ、USDZ等多种格式
• 🎮 实时预览 - 内置专业3D查看器，支持旋转、缩放
• 📥 本地导入 - 支持导入本地3D模型文件查看
• 💻 桌面应用 - 提供Windows桌面版本

🚀 快速开始

安装运行

方式一：使用虚拟环境（推荐）

# 1. 克隆项目
git clone <repository-url>
cd AI_3D_Generator_Complete_Package

# 2. 创建并激活虚拟环境
python -m venv venv
# Windows
.\venv\Scripts\activate
# Linux/Mac
source venv/bin/activate

# 3. 安装依赖
pip install -r requirements.txt

# 4. 启动后端服务
cd backend
python main.py

# 5. 在新终端启动前端
cd frontend
npm install
npm run dev

方式二：使用启动脚本

# Windows
./start.bat
# 或者使用PowerShell
./start.ps1

API 配置

首次使用需要配置火山引擎API密钥：

1. 访问 火山引擎控制台
2. 创建应用并获取API密钥
3. 在应用配置页面填入API密钥

📁 项目结构

AI_3D_Generator_Complete_Package/
├── backend/           # 后端服务（FastAPI）
│   ├── main.py       # 主程序
│   ├── api/          # API接口
│   └── config/       # 配置文件
├── frontend/         # 前端应用（React）
│   ├── src/          # 源代码
│   └── package.json
├── config/           # 项目配置
├── docs/             # 文档
└── website-deploy/   # 网站部署文件

🛠️ 技术栈

• 前端: React + Three.js + Ant Design
• 后端: FastAPI + Python
• AI服务: 火山引擎ARK
• 3D渲染: Three.js + React Three Fiber

📖 使用说明

详细使用教程请访问：https://suyuan-ai.xyz/tutorial.html

基本流程

1. 上传图片 - 选择或拖拽您想要转换的图片
2. 选择模型 - 从多款AI模型中选择适合的
3. 生成模型 - 点击生成，等待AI处理
4. 查看预览 - 在3D查看器中查看生成的模型
5. 导出保存 - 选择格式导出到本地

🤝 贡献指南

欢迎提交Issue和Pull Request！

📄 许可证

MIT License

📞 联系方式

• 官方网站: https://suyuan-ai.xyz
• 问题反馈: 提交GitHub Issue

---

Made with ❤️ by AI 3D Generator Team