Repolode
ahujasid

ahujasid/camera-to-blender

用手机拍摄真实物体,自动生成 3D 模型并导入 Blender。

Star
1,409
Fork
165
未关闭 Issue
1
最近提交
2个月前

这是什么?

Camera to 3D 可以把手机拍摄的真实物体照片转换为 Blender 中的 3D 模型。流程包括拍照、可选的背景去除、调用 Tripo3D API 生成模型,并通过 WebSocket 把结果自动导入 Blender。

项目由两部分组成:运行在 Blender 所在电脑上的 Python FastAPI 服务端,负责调用 API 和转发数据;以及适配手机的网页相机应用。手机浏览器要求 HTTPS 才能访问摄像头,因此部署时需要通过 ngrok 暴露本地服务,并把生成的地址填入 Blender 插件的 WS Import 面板。

生成 3D 模型必须提供 Tripo3D API 密钥。Gemini API 密钥为可选项,留空时将直接使用原图,不做背景去除。不使用手机时,也可以在本地运行服务并用笔记本摄像头拍摄。

核心功能

  • 01支持通过手机浏览器或笔记本摄像头拍照。
  • 02可选调用 Gemini API 去除照片背景。
  • 03通过 Tripo3D API 生成 3D 模型。
  • 04借助 WebSocket 插件将生成的模型自动导入 Blender。
  • 05提供 ngrok 配置方法,便于手机通过 HTTPS 访问。

适用场景

  • 将日常物品扫描进 Blender,作为参考或建模起点。
  • 把现实中的道具快速导入 3D 场景,用于预演。
  • 无需手动建模,快速制作 3D 素材原型。

快速上手

  1. 1

    安装 Python 依赖

    pip install -r requirements.txt
  2. 2

    启动中继服务器

    uvicorn relay_server:app --host 0.0.0.0 --port 8000
  3. 3

    在第二个终端中用 ngrok 通过 HTTPS 暴露服务器

    ngrok http 8000
  4. 4

    在 Blender 中安装 WS Import 插件并连接到你的 ngrok 地址

使用前须知

  • 需要 Tripo3D API 密钥才能生成 3D 模型。
  • 手机使用需要 ngrok,因为手机摄像头需要 HTTPS。
  • 免费 ngrok 地址每次重启都会变化,因此每次都需要在 Blender 中重新连接。

收录于专题

标签

常见问题

camera-to-blender 是什么?
用手机拍摄真实物体,自动生成 3D 模型并导入 Blender。 Camera to 3D 可以把手机拍摄的真实物体照片转换为 Blender 中的 3D 模型。流程包括拍照、可选的背景去除、调用 Tripo3D API 生成模型,并通过 WebSocket 把结果自动导入 Blender。
camera-to-blender 可以免费使用吗?用的什么许可证?
camera-to-blender 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
camera-to-blender 还在维护吗?
半年内有更新。camera-to-blender 最近一次提交是在 2026年9月5日。
camera-to-blender 适合用来做什么?
将日常物品扫描进 Blender,作为参考或建模起点。 把现实中的道具快速导入 3D 场景,用于预演。 无需手动建模,快速制作 3D 素材原型。
camera-to-blender 怎么安装和运行?
安装 Python 依赖: pip install -r requirements.txt 启动中继服务器: uvicorn relay_server:app --host 0.0.0.0 --port 8000 在第二个终端中用 ngrok 通过 HTTPS 暴露服务器: ngrok http 8000 在 Blender 中安装 WS Import 插件并连接到你的 ngrok 地址
在哪里获取 camera-to-blender?
源代码和安装说明在 GitHub 上:https://github.com/ahujasid/camera-to-blender

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目