混元生3D

要解决的具体问题

当你有一段中文描述、一张产品图，或几个视角图片，但需要得到可下载的 3D 模型时，手动建模往往成本高，直接调用 3D 服务又能避免重复实现云 API、轮询、错误处理和结果解析。

技能如何工作

本技能围绕腾讯云 ai3d 服务的两个 API 封装执行流程：SubmitHunyuanTo3DProJob 提交任务，QueryHunyuanTo3DProJob 查询结果。默认使用 main.py，传入 --prompt、--image-url、--image-base64 或 --multi-view 后即可提交并自动轮询。

它支持 PBR 材质、10000-1500000 面数、Normal / LowPoly / Geometry / Sketch 等生成类型，以及 obj+glb、STL、USDZ、FBX 等输出格式。若需要异步流程，可先用 submit_job.py 拿到 JobId，再用 query_job.py 查询状态。

返回结果通常包含文件类型、Url 和 PreviewImageUrl，其中 3D 文件 URL 仅保留 24 小时。

适用边界与注意点

• 需要已开通混元 3D 服务并配置腾讯云 API 密钥，脚本会优先读取环境变量。
• 生成通常需要 1～5 分钟，结果 URL 有有效期，需及时保存。
• 模型 3.1 不支持 LowPoly；图片分辨率建议 128~5000，URL 输入不超过 8MB，Base64 输入不超过 6MB。
• 调用失败时应保留错误码和错误信息，不应编造文件地址。