建模流程

本文說明建模任務從創建到下載產物的完整鏈路、任務狀態流轉，以及建模產物的構成。調用前請先完成 接入指南 中的準備工作。

輸入數據要求

請按建模需求選擇輸入數據：

上傳形態支持兩種：

• 完整目錄形態：多文件按相對路徑直接上傳到 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 等。