建模流程

本文说明建模任务从创建到下载产物的完整链路、任务状态流转，以及建模产物的构成。调用前请先完成 接入指南 中的准备工作。

输入数据要求

请按建模需求选择输入数据：

上传形态支持两种：

• 完整目录形态：多文件按相对路径直接上传到 input 目录下。
• 压缩包形态：上传 .zip，服务端自动解压。

最简接入流程

1. 创建任务：调用 创建任务并获取上传密钥。默认开启自动建模（autoRebuild = 1），返回建模任务 modelId 与上传所需的临时凭证。
2. 上传建模输入数据：使用上一步返回的临时凭证，调用对应云服务商的对象存储接口进行分片上传，方式见 临时上传凭证。文件最终 Key 为 savePath 加文件相对路径，例如 savePath + "render2/info/poses.json"。
3. 通知上传完成：文件全部上传成功后，调用 上传状态更新，传 status = 3。系统将自动触发建模流程。
4. 轮询任务进度：调用 任务列表分页查询 或 任务信息详情查询，关注 status 与 percent。status = 8 为建模完成，status = 9 为建模失败。轮询间隔建议不低于 5 秒。
5. 下载建模产物：调用 建模成果下载 获取产物临时下载链接。

注：建模任务并发不做限制。可同时提交多个建模任务，任务提交后直接进入排队，由算力中心按节点空闲情况调度执行。

其他支持流程

断点续传与凭证过期处理

上传中断或临时凭证过期时，调用 再次获取上传密钥 取得新的临时上传凭证后，可继续分片上传。

手动触发建模

适用于创建任务时设置了 autoRebuild = 0、且输入数据已全部上传完成的场景。调用 任务开始执行 手动触发建模。

任务状态机

自动建模场景下的状态流转：

0 等待上传 → 1 上传中 → 3 上传完成 → 6 排队中 → 7 建模中 → 8 建模完成
                ↓                                           ↓
            4 上传失败                                  9 建模失败

建模产物

建模完成后产出以下成果，核心下载产物为 LCC 原生坐标三件套。

其余辅助成果包括户型 BEV 图、点云叠加图、家具布局图、整体渲染预览图、坐标变换元数据 coordinate_transform.json 等。