概述 #

当前 AI 生成的 3D 资产有不错的视觉效果，但由于缺少尺寸、刚体、质量、摩擦等关键物理属性，无法直接进入机器人仿真、具身智能训练与评测流程，这也是造成 sim2real gap 的主要原因之一。
SimReady 3D 运行于火山方舟 Managed Agents（MA）平台，打通 Seed3D 相关能力，可将输入图片或已有 3D 资产处理为具备关键物理属性、可用于仿真的资产状态；支持在 MA 中以对话方式使用，也提供 API 接入既有流程。

快速开始体验入口：https://ark.volcengine.com/region:cn-beijing/managed-agents/quickstart

效果展示 #

以下示例展示从图片到可用于仿真资产的完整链路：输入图片经 Seed3D 生成 3D 模型，再由 SimReady 3D 补齐满足仿真运行与机器人交互要求的资产表达，如摩擦、碰撞、质心，并通过静态检查与运行时验证，最终导入仿真环境使用。

完成 Agent 创建后，可在 Session 中提交任务并获取产出资产与检测报告。下面是一个完整示例：

最佳实践 #

Quickstart 创建 Agent #

1. 请提前准备 Seed3D 2.0（或其他 3D 生成模型）的 API Key，该配置仅需在首次创建 Agent 时完成。
2. 进入火山方舟 Managed Agent，选择 SimReady 3D 模板并确认创建（预计 5 分钟）。
   
3. 依照提示配置生成式 3D 模型的 API Key。如果不需要使用（如仅输入资产进行 mesh 处理或仿真验证），可在配置界面向 Agent 发送“跳过此项配置”。
   1. 配置 SEED3D_ARK_API_KEY（Seed3D 模型），变量名为 SEED3D_ARK_API_KEY，value 值为用户自己创建的 API Key。
   2. 确认创建 Environment。
   3. 确认创建 Session。

提交任务输入 #

输入要求与限制

使用 Seed3D 2.0（doubao-seed3d-2-0-260328）图生 3D 时，输入图片需满足以下要求（详见创建 3D 生成任务 API）：

• 图片数量：1 张。
• 图片格式：jpeg、png、webp、bmp、tiff、gif。
• 宽高长度（px）：[300, 6000]。
• 大小：单张图片小于 30 MB；请求体不超过 64 MB，大文件请勿使用 Base64 编码。
• 输出配置：面数 low = 10 万面、medium = 50 万面、high = 100 万面（默认 medium，对应上文“中面数”约 50 万面）。任务 ID 与产出文件在火山方舟公有存储空间保存 7 天。

3D 资产生成

• 指令：使用 <模型> 生成 <面数> 面数的 SimReady 资产，面数可选低、中、高；默认使用 Seed3D + 中面数（约 50 万面）。
• 示例：使用 Seed3D 生成低面数的 SimReady 资产。

文件挂载方式

1. 对话中通过 TOS 配置
   • 指令：“把当前 <文件> 上传到 <桶路径>，<地域>，<访问凭证>。”
   • 示例：“把当前所有产出文件上传到 tos://abcefd，地域是 cn-beijing，访问凭证 AK/SK 为 xxx。”
     
2. 对话中直接上传
   • 对话中上传的文件将存储在火山方舟公有存储空间，保存时长为 7 天。

其他任务类型

• 已有资产检测修复：上传 USD 资产文件，并发送指令“使用 SimReady 工具检测修复当前资产”。
• 已有真值赋值（可选）：上传 USD/图片文件和已测量真值，并发送指令“使用当前参数生成 SimReady 资产”。
• 仿真抓取验证（可选）：对训练、评测或交付等关键资产，建议在生成完成后补充仿真抓取验证。发送指令“在 Isaac 中进行仿真验证”。该任务为异步后台执行，不会被自动轮询；Agent 结束任务后，在对话中询问仿真验证结果即可。

Quickstart UI 交互使用 #

在 Quickstart 右侧对话框中发送文件和文字指令。

Session UI 交互使用 #

1. 在 Quickstart 页面复制已经创建的 Session ID。
2. 在 Managed Agent 左侧边栏点击 Sessions，粘贴并搜索 Session ID，进入 Session 对话，在对话框中发送文件和文字指令。
   
3. 任务完成后，在 Session 上方的“产出文件”中下载本次任务生成的所有产物。
   
4. 将产物压缩包保存到本地，即可查看生成产物以及检测报告。

调用 API #

在 Quickstart 页面或 Session 对话中点击“API 接入”，即可获得示例代码。

可视化开发机验证（Isaac streaming） #

用户可在火山引擎机器学习平台创建开发机，挂载 TOS 路径直接访问生成的 3D 资产。通过 Isaac streaming 最佳实践，在 Web 端访问 USD 文件并继续开发仿真环境。