实战 SOP
实战 SOP

一张图变 3D:img2threejs 与 Meshy 双路线工作流

AI 图像转 3D 工作流 SOP:两条路线决策--img2threejs 代码化(开源免费,规则物体)vs Meshy/Tripo mesh(SaaS,复杂有机体)。5 步:素材准备->路线选型->生成->质检修正->导出集成。含可跑命令+5 踩坑+5 FAQ。

发布于 2026年8月12日8 分钟阅读
<!-- ai-image-to-3d-workflow-sop | sop | 一张图变 3D:img2threejs 与 Meshy 双路线工作流 -->

AI 图像转 3D 有两条路:一条生成 Three.js 程序代码,一条生成 GLB/FBX mesh。前者免费开源、token 高效、可编辑,擅长规则物体(几何/建筑/道具);后者付费 SaaS、auto-rigging,擅长复杂有机体(人物/生物)。选错路线等于白做--拿 img2threejs 去重建人物面部会崩,拿 Meshy 去生成一个方块几何体则大材小用。

这篇 SOP 给你一个可复制的五步流程:素材准备 -> 路线选型 -> 生成 -> 质检修正 -> 导出集成。img2threejs 命令据官方 README 核实(截至 2026-08-12),Meshy/Tripo 以官网为准。与同批的 img2threejs 开源项目解析(代码化原理深入)、AI 3D 生成工具横评(选哪个 SaaS)、AI 3D 生成爆发热点(趋势)互补:那几篇解决「为什么、选什么」,这篇解决「怎么动手做」。


一、两条路线:代码化 vs mesh

核心决策在动手前就定了:你要的是可编辑的程序代码,还是现成的 mesh 文件。两条路线的产物、成本、适用场景完全不同。

维度img2threejs(代码化)Meshy / Tripo(mesh)
产物TypeScript Three.js 工厂代码GLB / FBX mesh 文件
价格免费开源(Apache-2.0,11315★)$19.9-19.99/mo 起
运行依赖Three.js 运行时任意 3D 软件/引擎
擅长规则物体(几何/建筑/道具/武器)复杂有机体(人物/生物/怪物)
auto-rigging无(代码内动画)有(Meshy/Tripo 支持)
可编辑性高(代码可直接改)低(mesh 难以程序化修改)
token 效率高(脚本做苦力,模型只判视觉)不适用(云端处理)

一句话:规则物体、要可编辑、不想花钱 -> img2threejs 代码化;复杂有机体、要游戏资产、需绑骨 -> Meshy/Tripo mesh。


二、SOP 五步流程

Step 1:素材准备

无论走哪条路,参考图质量决定上限。三件事:

干净背景。 杂乱背景会干扰模型对物体轮廓的判断。用纯色背景拍或后期抠图,让目标物体占画面主体。

多视角。 单张正面图只能重建正面。有条件拍正面、侧面、背面三视图。img2threejs 支持多视角 silhouette carving(视觉外壳交叉),Meshy 也接受多图输入提升背面精度。

细节清晰。 螺丝、接缝、磨损、光泽差异--这些 identity-defining details 决定重建忠实度。参考图分辨率不低于 1024px,光照均匀避免硬阴影。

Step 2:路线选型

按物体类型分叉:

  • 规则物体(家具、建筑、道具、武器、容器)-> img2threejs 代码化。这类物体由几何体组合而成,程序化重建天然适配。
  • 复杂有机体(人物、动物、怪物、植物)-> Meshy/Tripo mesh。有机体的曲面拓扑和皮肤纹理超出代码化重建的能力范围。
  • 混合体(角色持武器、建筑内摆件)-> 拆分后分别走两条路线,最后在引擎里组合。

Step 3:生成

代码化路线(img2threejs):

img2threejs 是 Claude Code 的 skill,不是 pip 包。安装方式是把仓库克隆到 skills 目录:

bash
git clone https://github.com/img2threejs/img2threejs.git ~/.claude/skills/img2threejs

在 Claude Code 里附上参考图,调用:

text
/img2threejs Rebuild this object as a Three.js model, keep the proportions, angles, and colours.

skill 会自动分类物体、枚举细节清单、逐 pass 生成并质检。如果你想手动跑管线脚本(需 Python 3.10+,纯标准库零依赖):

bash
# 1. 探测图片元数据
python3 forge/stage1_intake/probe_image.py <image>

# 2. 生成评估和规格
python3 forge/stage2_spec/new_pre_spec_assessment.py "Name" --image <image> --out assessment.json
python3 forge/stage2_spec/new_sculpt_spec.py "Name" --image <image> --assessment assessment.json --out spec.json

# 3. 严格质检(不通过则阻止生成)
python3 forge/stage2_spec/validate_sculpt_spec.py spec.json --strict-quality

# 4. 生成 Three.js 工厂代码
python3 forge/stage3_build/generate_threejs_factory.py spec.json --out src/createObjectModel.ts

生成的是 TypeScript 文件,导出一个 THREE.Group 工厂函数,由图元、程序化着色器和生成几何体组成,带运行时层级(pivots、sockets、colliders),可以直接丢进 Three.js 场景跑动画。

多会话重建时,先创建本地状态索引:

bash
python3 forge/state.py init --reference <image> --profile character --spec object-sculpt-spec.json
python3 forge/next.py --state .img2threejs/state.json

mesh 路线(Meshy/Tripo):

上传参考图到 Meshy 或 Tripo 的 Web 界面,选参数(风格:写实/PBR/卡通;细分级别;是否 auto-rigging),点生成。产出 GLB/FBX 文件直接下载。不需要本地环境,全程浏览器操作。

Step 4:质检与修正

代码化路线质检: img2threejs 内置逐 pass 质检(blockout -> structural -> form -> material -> surface -> lighting -> interaction -> optimization),每 pass 有 side-by-side 对比图。--strict-quality 模式下规格不达标会 fail-closed 阻止生成。如果生成结果不满意,检查:参考图角度是否不足、细节清单是否遗漏、spec.json 是否被手动改坏。

mesh 路线质检: 下载 GLB 后在 Blender(免费开源)里检查三件事:拓扑是否干净(有没有破面/重叠顶点)、贴图是否对齐(UV 有没有错位)、绑骨是否合理(关节弯曲有没有穿模)。Meshy/Tripo 的 auto-rigging 不完美,复杂姿势常需手动调权重。

Step 5:导出集成

按目标平台分:

  • Three.js Web:代码化路线的 TypeScript 直接 import 进项目,零额外文件。mesh 路线的 GLB 用 GLTFLoader.load() 加载。
  • Unity / Unreal:mesh 路线的 FBX/GLB 直接导入引擎。代码化路线需先把 Three.js 代码跑起来导出 GLB(用 GLTFExporter),再导入引擎。
  • 3D 打印:mesh 路线的 GLB 转 STL。代码化路线同样需先导出 mesh 再转 STL--代码本身不能直接打印。

三、五个踩坑

坑 1:参考图背景干扰,轮廓识别跑偏 杂物背景让模型把背景物体也当成重建目标,生成的模型多出一堆奇怪的附属物。修法:拍前铺纯色背景布,或用抠图工具(rembg、Photoshop 主体选择)把背景去掉。多视角图更要注意背景一致。

坑 2:代码化 vs mesh 选错,白费力气 拿 img2threejs 去重建人物面部,出来的几何体像乐高积木;拿 Meshy 去生成一个方盒子,花钱花时间还得不到可编辑代码。修法:选型前先判断物体类型--规则几何走代码化,有机曲面走 mesh。混合体拆分处理。

坑 3:生成质量不稳定,同图不同结果 AI 生成有随机性,同一张参考图跑两次结果可能差很多。img2threejs 的 --strict-quality 能过滤低质量输出但也会直接 BLOCKED。Meshy/Tripo 每次生成消耗 credits。修法:多跑几次取最优;img2threejs 用多视角输入提升稳定性;Meshy/Tripo 先用免费额度试参数再正式跑。

坑 4:贴图/绑骨需手动修,auto-rigging 不是万能的 Meshy/Tripo 的 auto-rigging 对简单姿势还行,复杂姿势(坐姿、握拳、扭头)常出现关节穿模、权重错误。贴图在高光区域也可能偏色。修法:下载后在 Blender 里手动刷权重、用 Substance Painter 修贴图。别指望 auto-rigging 一步到位。

坑 5:导出格式与目标平台不匹配 Three.js 项目拿到 FBX 用不了,Unity 项目拿到 TypeScript 也跑不起来。3D 打印需要 STL 但 mesh 工具默认导出 GLB。修法:导出前确认目标平台需要的格式--Web 用 GLB/代码,Unity 用 FBX,Unreal 用 FBX/USD,3D 打印用 STL/OBJ。格式转换用 Blender 或 assimp 命令行工具。


四、常见问题

Q1:img2threejs 和 Meshy/Tripo 怎么选? A1:看物体类型。规则物体(家具、建筑、道具、武器)选 img2threejs,免费、可编辑、token 高效;复杂有机体(人物、动物、怪物)选 Meshy/Tripo,auto-rigging 和 mesh 拓扑更适合有机曲面。两者不是替代关系,是互补关系。详见同批 AI 3D 生成工具横评

Q2:img2threejs 生成的代码能直接用吗? A2:能。生成的是 TypeScript 文件,导出 THREE.Group 工厂函数,带 pivots、sockets、colliders 运行时层级,import 进任何 Three.js 项目即可使用。前提是你的项目用 Three.js 运行时。如果目标是 Unity/Unreal,需先用 GLTFExporter 导出为 GLB 再导入。

Q3:参考图有什么要求? A3:三条:干净背景(纯色或抠图后)、细节清晰(分辨率不低于 1024px,光照均匀)、多视角更佳(正面/侧面/背面三视图能大幅提升背面精度)。手机拍的照片可以用,但要注意避免严重透视变形和过曝/欠曝。

Q4:生成一个 3D 模型大概要花多少钱? A4:img2threejs 免费开源,但需要 Claude Code 的 API 额度(模型只做视觉判断和写代码,token 消耗相对可控)。Meshy 起价 $19.99/月,Tripo 起价 $19.9/月,每次生成消耗 credits,具体以官网定价为准。建议先用免费额度试跑,参数调好再批量生成。

Q5:能不能用手机拍的照片做参考图? A5:能,但效果取决于照片质量。手机照片常见问题:透视变形(广角镜头让直线变弯)、动态模糊、光照不均。修法:用主摄不要用超广角、光线充足时拍、保持手机与物体平行减少透视。有条件用扫描 App(如 Polycam)做辅助参考。img2threejs 和 Meshy/Tripo 都接受单张照片输入,但多视角始终优于单视角。


参考来源

本文由 AI 辅助生成,经人工审核编辑。最后更新:2026-08-12

常见问题

img2threejs 和 Meshy/Tripo 怎么选?
看物体类型。规则物体(家具、建筑、道具、武器)选 img2threejs,免费、可编辑、token 高效;复杂有机体(人物、动物、怪物)选 Meshy/Tripo,auto-rigging 和 mesh 拓扑更适合有机曲面。两者不是替代关系,是互补关系。详见同批 [AI 3D 生成工具横评](/zh/ai-3d-generation-tools-comparison-review)。
img2threejs 生成的代码能直接用吗?
能。生成的是 TypeScript 文件,导出 THREE.Group 工厂函数,带 pivots、sockets、colliders 运行时层级,import 进任何 Three.js 项目即可使用。前提是你的项目用 Three.js 运行时。如果目标是 Unity/Unreal,需先用 GLTFExporter 导出为 GLB 再导入。
参考图有什么要求?
三条:干净背景(纯色或抠图后)、细节清晰(分辨率不低于 1024px,光照均匀)、多视角更佳(正面/侧面/背面三视图能大幅提升背面精度)。手机拍的照片可以用,但要注意避免严重透视变形和过曝/欠曝。
生成一个 3D 模型大概要花多少钱?
img2threejs 免费开源,但需要 Claude Code 的 API 额度(模型只做视觉判断和写代码,token 消耗相对可控)。Meshy 起价 $19.99/月,Tripo 起价 $19.9/月,每次生成消耗 credits,具体以官网定价为准。建议先用免费额度试跑,参数调好再批量生成。
能不能用手机拍的照片做参考图?
能,但效果取决于照片质量。手机照片常见问题:透视变形(广角镜头让直线变弯)、动态模糊、光照不均。修法:用主摄不要用超广角、光线充足时拍、保持手机与物体平行减少透视。有条件用扫描 App(如 Polycam)做辅助参考。img2threejs 和 Meshy/Tripo 都接受单张照片输入,但多视角始终优于单视角。

相关文章

实战 SOP

LLaDA-Image 本地部署 SOP:五步跑通 6B 生图模型

把蚂蚁开源 6B 生图模型 LLaDA-Image 跑起来的五步 SOP:①环境准备(依赖与国内镜像加速下载);②四档权重怎么选(Base 50 步 / Turbo 4 步 × BF16 / FP8,国内走 ModelScope);③跑通第一张图(Base 与 Turbo 最小可用命令);④进阶(参考图编辑、文字渲染、ComfyUI 接入、显存不足时的降级策略);⑤生产化(批量队列、并发容量规划、成本监控、结果入库与故障降级)。含 6 条踩坑与 10 项上线自检清单,命令逐字取自官方 README;仓库 license 为 null,商用前须确权。

2026年9月9日11 分钟阅读