技能介绍

要解决什么问题

把一张产品图或概念草图变成可进引擎、可上架展示的 3D 资产，往往要经历建模、UV、贴图与格式导出，周期长且对工具链熟悉度要求高。若还需要从文字描述快速出模，传统流程更难在脚本或流水线里复用。本技能面向「图生 3D」与「文生 3D」两类输入，由忆捷开放平台 API 生成带 PBR 纹理 的模型，并落到 GLB/glTF 这类通用格式，便于接入游戏、AR/VR、电商 3D 展示或仿真管线。

技能如何工作

图生 3D：提供本地图片路径（宽度建议 ≥300px，常见 PNG/JPG），可选 prompt 约束风格、材质与细节；生成结果包含压缩包与核心文件 pbr/mesh_textured_pbr.glb。
文生 3D：以文字提示词描述目标模型，适合没有参考图时的原型与个性化资产。
调用形态：支持 Shell 脚本（适合批量与终端）与 Python 集成（适合自动化）；api_key 优先从本地配置文件读取（文档约定路径 ~/.doubao-seed3d-key），output_dir 可指定输出目录。
资源与耗时：单次任务文档说明约 3～5 分钟，并会消耗一定 token 配额（文档标注约 30000 tokens/次）。

适用边界与注意点

首次使用需在忆捷开放平台注册并申请 API 密钥，写入本地配置后长期复用。常见失败原因包括密钥缺失、图片分辨率不足或路径异常（含中文路径乱码）、网络波动导致超时；依赖缺失时按终端提示安装 Python 库即可。生成品质与输入图清晰度、prompt 具体程度相关，复杂造型应预留等待时间，并在下游 DCC/引擎中自行做尺度、法线与碰撞体等工程化处理。