🚀 OpenSCAD 3D 模型生成服务器
本项目是一个 3D 模型生成服务器，支持多种图像生成 API，可进行多视图处理和 3D 模型重建，还能导出多种 3D 文件格式，为 3D 模型的创建提供了便捷的解决方案。
🚀 快速开始
本服务器可帮助你快速生成和处理 3D 模型，以下是使用前的安装和基本使用说明。
📦 安装指南
安装要求
- 操作系统：支持 Linux 或 Windows（推荐使用 Ubuntu 20.04+）
- Python 版本：Python 3.8+
- 依赖库：OpenCV、Flask、requests、jsonschema、numpy、open3d
- CUDA 支持：CUDA 11+，用于加速 3D 模型重建
安装步骤
git clone https://github.com/your-repository.git
cd openscad-server
pip install -r requirements.txt
✨ 主要特性
- 图像生成：支持 Gemini 和 Venice.ai API，可自定义视角数量和风格。
- 多视图处理：通过 Web 界面审批和管理多视图图像。
- 3D 模型重建：利用 CUDA MVS 技术进行模型重建，支持本地与远程服务器计算。
- 格式导出：支持 OBJ、STL、PLY、SCAD 等多种 3D 文件格式。
💻 使用示例
基础用法
图像生成
{
"prompt": "一只可爱的兔子",
"num_views": 4,
"model": "gemini-2.0-flash-exp-image-generation"
}
多视图重建
{
"image_ids": ["view_1.jpg", "view_2.jpg", "view_3.jpg", "view_4.jpg"],
"output_name": "兔子模型"
}
📚 详细文档
功能选项
图像生成选择
-
Google Gemini API（默认）：采用 Gemini 2.0 Flash Experimental 模型，提供高质量图像。
- 支持多视图风格一致生成，需配置 Google API Key。
-
Venice.ai API（可选）：支持 flux-dev 和 fluently-xl 等多种模型。
- 需配置 Venice.ai API Key。
-
自定义图像：上传本地图片，适用于已有照片或渲染图。
多视图工作流
- 生成多视角图像
- 审批通过的图像
- 转换为 3D 模型（支持本地与远程 CUDA MVS）
- 可选 OpenSCAD 进行模型优化
远程处理流程
- 发现网络中的 CUDA MVS 服务器
- 上传审批后的多视图图像到远程服务器
- 提交作业并追踪进度
- 下载完成的 3D 模型
支持导出格式
- OBJ：波front 对象文件（标准 3D 模型）
- STL：标准三角形语言（适合 3D 打印）
- PLY：多边形文件格式
- SCAD：OpenSCAD 源代码
- CSG：OpenSCAD CSG 格式（保留所有参数属性）
- AMF：增材制造文件格式
- 3MF：3D 制造格式（现代 STL 替代品）
Web 界面
访问地址：http://localhost:8000/ui/
功能包括：
- 生成与审批多视图图像
- 预览 3D 模型（支持旋转缩放）
- 管理 API 密钥和服务器配置
- 查看历史作业记录
📄 许可证
本项目遵循 MIT 协议，代码仓库地址：OpenSCAD 服务端
🤝 贡献指南
欢迎提交 PR 或 ISSUE：
- 提交问题请包含日志文件和详细描述
- PR 前需通过单元测试
- Fork 仓库并基于 main 分支开发