混元 3D 3.1 Pro 多视角怎么填?五组请求实测
用同一设备箱对照正面、正背、前斜视角、六张图和左右填反,展示轮廓、背面深度、实扣与字段用法。

给混元 3D 3.1 Pro 多补一张背面图后,这个设备箱的背面平均深度差从最长边的 5.22% 降到 4.85%。六张图按正确字段提交,侧面轮廓交并比为 57.72%。把同样六张图的左右字段对调后,降到 48.91%。分数较高的结果仍没有做出原件后方伸出的接口。下面把该怎么填字段、如何发现填错以及怎样验几何放在同一次测试里。
先说结论
image放正面。补拍的每张图都按同一套物体方位命名,再把文件填进对应字段。左右以预先定义好的物体方向为准。- 用同样六张图,正确填写左右字段的侧面轮廓交并比高出 8.81 个百分点。这是一对请求的结果,后方接口还是没有正确复现。
- 正背两张的背面平均深度差最低,六张正确分配的请求侧面轮廓交并比最高。验收时按最终要展示的面和必须出现的结构选参考图。
- 请求 40,000 面的纯几何文件,单正面实扣 $0.525,带补图的四次均实扣 $0.675,五次合计 $3.225。
先定义正面,再拍其他方向
SandBase 的混元 3D 3.1 Pro 图生 3D要求提供正面一张,其余角度有独立字段。我们先做了一个测试设备箱,有手柄、正面三颗按钮、左右不同的面板和后面突出的圆形接口。有原始网格,就可以核对生成结果。这个箱子的正面外轮廓很规则,背后的接头却明显凸出,适合检验只看正面时容易漏掉的问题。
我们环绕同一网格,用固定的正交相机渲染八张 768 × 768 PNG。测试件在 Three.js 面朝 +Z,left 对应 −X 机位,right 对应 +X 机位,背面在 −Z。左右前方各拍一张,画面里同时出现正面和对应的一侧。顶面和底面也按固定的取向保存,能辨认出哪条边通向正面。实拍时先固定这个约定,再移动相机或转台。这样复核文件名时还能追溯是哪一侧。

每格是同一件测试物体从一个相机位置渲染的 PNG。图中方位沿用本次采集约定,发请求时分别提交原图。
| 字段 | 提交什么视角 |
|---|---|
image | 必填正面,带容易辨认的朝向特征 |
back_image | 与正面相对的背面,拍到背面独有的结构 |
left_image、right_image | 约定好的左右侧轮廓各一张 |
top_image、bottom_image | 顶部及底部,保留对正面方向的提示 |
left_front_image、right_front_image | 左前和右前各一张,每张可见正面和一侧 |
目前请求格式列了七个补图字段,模型页说明写的是最多六张补图。本文分别用到了全部命名字段,单次最多提交五张补图,未测试七个字段同时传入。
正面图和生成配置保持一致
五次全部使用 generate_type: "Geometry"、face_count: 40000、enable_pbr: false,正面 PNG 相同。第一份只交正面,第二份加背面,第三份加左右前方两个斜视图。第四份交正、背、左、右、顶、底六张,第五份复用同样六张图但对调两个侧面字段。最后两组请求只改变左右两张的分配。每种配置只跑一次,所查接口也没有种子字段。

对原始网格分别居中并按最长边缩放。相机和中性材质相同,可以看轮廓和面板几何。
从正面看,各组都能做出箱体、手柄和两侧凸起的大概位置。单图与正确六视角结果的正面轮廓交并比分别为 94.99% 和 97.94%,侧面分别只有 55.22% 和 57.72%。如果页面默认给正面,再允许用户拖动旋转,只验首页的静态效果会漏掉箱体深度和背部凸起。在固定机位截图后,建议切到侧面检查最突出的结构是不是还在。
背面补图后,仍要转到侧面验突出结构
只交正面时,生成结果的背面出现三个圆形印记,位置和布局看起来像正面的按钮。加背面图的结果不再明显显示这三个圆形,但该区域整体还是偏平。六张正确分配的结果背面也带圆形轮廓,仍没有还原原件向后伸出的接口。背板上的一个圆形印记和从侧面看得见的圆柱并不等价,最终画面要旋转时应分别检查。

所有文件共用一个背面机位,材质统一为中性,图里只呈现几何。
原始测试件前后跨度为最长边的 83.67%。Blender 测得单图结果约 40.80%,正确六张约 51.05%。对调两侧的结果反而更厚,约 54.49%,但侧面轮廓交并比下降。单个突出点就可能拉长包围盒,厚度更接近也未必找回要验收的部件。侧图里还可以看到左右填反那一版的底脚、手柄轮廓与其他结果不同。

各模型先用自己的最长边统一尺寸,再用同一个侧面机位拍摄。保留交付的几何形状。
用原始测试件做轮廓和深度对照
我们用 Blender 4.5.9 导入各 GLB,分别按包围盒居中,再除以各自最长边。比较 0°、90°、180°、270° 四个绕竖轴的朝向,以正面交并比减去正面平均深度差选角度。五份输出都选中原始 0°。然后从六个坐标轴方向各投一组 128 × 128 正交射线,对照原始箱子和返回的 GLB。
轮廓交并比用两边同时命中的像素除以至少一边命中的像素。相对两个正交视角的整体占用区域是镜像对应的,因此单靠背面的轮廓重合很难独立评价背板。深度量的是两边在同一像素第一次击中网格的位置差,只对两份都命中的像素计平均值,按归一化最长边比例报告。一边完全缺失的区域若改变外轮廓,会反映在交并比上,这些像素则不计深度差。需要配合图看具体缺口,也不能把归一化后的比例直接换算为实物尺寸。

侧面交并比使用投影掩码。背面深度差限于两份都命中的像素。费用为该配置的实际扣款。
| 请求 | 三角面 | 原始 GLB 字节 | 侧面轮廓交并比 | 背面平均深度差 | 实扣 |
|---|---|---|---|---|---|
| 仅正面 | 40,000 | 480,732 | 55.22% | 5.22% | $0.525 |
| 正面+背面 | 40,000 | 480,728 | 55.89% | 4.85% | $0.675 |
| 正面+两张前斜视图 | 39,924 | 479,820 | 52.46% | 5.24% | $0.675 |
| 六张,字段正确 | 40,000 | 480,732 | 57.72% | 5.27% | $0.675 |
| 同六张,左右对调 | 40,000 | 480,684 | 48.91% | 6.53% | $0.675 |
五份输出都是单网格,没有内嵌图。glTF 格式校验零报错和零警告,最大与最小文件只差 912 字节。文件大小和面数几乎一样时,字段对调造成的变化仍然可能影响交付。这里的实扣包含指定面数,传任意一个补图字段会收一次多视角费用。Pro 和 Rapid 的用途及交付另见混元 3.1 Pro 与 Rapid 实测。
用拍摄清单来组请求
给正背面、左右和斜视图留不同的文件名,同一组拍摄保持物体状态、取景和光线。展示后部标记时先补背面,然后从背面看实际交付。需要表现接口突出多少时,再加侧面,并用固定侧面机位核对接口与外壳的相对位置。批量提交前,可以先生成一张包含字段名和缩略图的清单,发现左右填反或者同一张图填进两个字段时直接修正。
把下面 JSON 发到 POST https://api.sandbase.ai/v1/run,服务端保管 Bearer Token,用返回 ID 请求 GET /v1/run/{id} 查状态。示例地址换成实际图像地址,每次调用可能产生费用。
{
"model": "tencent/hunyuan-3d/3.1/pro/image-to-3d",
"image": "https://example.com/case-front.png",
"back_image": "https://example.com/case-back.png",
"left_image": "https://example.com/case-left.png",
"right_image": "https://example.com/case-right.png",
"top_image": "https://example.com/case-top.png",
"bottom_image": "https://example.com/case-bottom.png",
"generate_type": "Geometry",
"face_count": 40000,
"enable_pbr": false
}五条多视角 API 实测沿用同一设备箱,对比两图和四图在侧面轮廓、整张背面及接口区的表现。
常见问题
都是六张图,填错字段有影响吗?
本次同一套图的左右顺序对调后,侧面交并比下降,背面平均深度差上升。遇到像镜像或者侧面变形的结果,先看每个字段实际指向哪张图。
背面深度差更低,表示后部接口做对了吗?
要单独看接口。深度均值覆盖所有共同命中的像素,平整的背板占比很大,接口的小范围缺失仍可能被平均值掩盖。
五次调用由 SandBase 于 2026 年 11 月 14 日 UTC(北京时间 11 月 15 日)执行并计费。图中是自制参考物或实际交付的几何,封面为示意图。
觉得有用?分享给更多人