展开本页目录
开始前准备什么
- 把本题ZIP解压到独立目录，保留原始文件与README中的素材身份。
- 模型步骤需在官方支持的隔离环境、相应权重与硬件中运行；本包不含权重，不承诺Apple本机支持CUDA。
- 本地文件检查使用Python、NumPy/Pillow或Blender；模型运行与素材/格式校验是分开的证据。
- 先重载现成网格确认形状
- 检查参考图是否属于同一物件
- 按官方Paint示例准备独立纹理管线
- 把现成mesh与参考图传给Paint
- 实际导出后核对几何是否改变
- 旋转检查接缝与纹理遗漏
- 区分AI贴图与手工交换文件参考
原创输入、真实参考文件、命令、脚本、运行边界与逐项清单；不含模型权重。
明确哪些材料已运行，哪些目标模型步骤尚未执行。
真实可打开的练习输入或手工参考，均不是目标模型输出。
1. 先重载现成网格确认形状
打开reference-colored.glb，检查顶点、面数和三个不对称结构；本包同时有实际烘焙参考。运行前复制一份source-mesh.glb，不允许纹理任务覆盖唯一原件。
2. 检查参考图是否属于同一物件
front/left/back是同一原创场景的真实三视图。比对天线、电池和足部颜色，避免把三种不同商品当成“多视图风格参考”后要求模型保证一致。
3. 按官方Paint示例准备独立纹理管线
示例从hy3dgen.texgen导入Hunyuan3DPaintPipeline，加载2.0的paint-v2-0-turbo子目录。纹理依赖和custom rasterizer需按官方环境编译，形状模型能跑不等于纹理环境已可用。
commands.md
# 复制并保留原网格，在官方Hunyuan3D-2匹配环境运行
python run-hunyuan-task.py --repo /path/to/Hunyuan3D-2 --task paint --mesh source-mesh.glb --out actual-painted.glb
# 离线手工参考查看
python3 -m http.server 8391 --bind 127.0.0.14. 把现成mesh与参考图传给Paint
参照run-hunyuan-task.py的paint分支，trimesh加载source-mesh.glb，再把参考图列表传给pipeline(mesh,image=images)。此步不调用shape管线；若输入mesh是Scene先按真实版本处理，不能默默丢掉其他对象。
5. 实际导出后核对几何是否改变
将真实结果另存actual-painted.glb，比较输入与输出的结构、面数和尺度；记录管线对网格的实际处理。不要仅根据“Paint”这个名字就声称顶点逐字节不变。
6. 旋转检查接缝与纹理遗漏
按正侧背三个角度看边界，尤其电池、天线背侧和脚底。UV缝和灯光高光不同，固定查看器照明后再判断，记录未覆盖区域与错误细字。
7. 区分AI贴图与手工交换文件参考
包内reference-textured.obj/MTL/PNG是Blender实际烘焙的手工材料，验证重载与纹理文件关系；模型纹理尚未生成。两套材料不能互相更名来填满结果图。
怎样确认已经完成
- 原始输入、人工参考、官方示例和实际模型输出标识分开。
- 保存真实帧号/坐标/对象ID或几何版本，不只凭文件能打开判断质量。
- 模型未运行时保留not-executed，不把参考文件复制更名为成功结果。
常见问题
AI给白模上材质会重新建模吗？
本教程调用现有mesh的Paint接口，不再主动调用shape生成；实际输出仍要比较网格和尺度，不能承诺内部处理绝不改变几何。
为什么已经有一张reference-texture.png还需要运行Paint？
这张PNG是Blender把手工材质实际烘焙成的参考图集，用于测试OBJ/MTL和UV；它不是Paint模型结果。
Hunyuan3D Paint能填apizt Base URL吗？
本题是官方专用本地纹理模型管线，不是OpenAI Chat或Images接口。本站不会因提供教程就托管该3D模型。