POST /v1/3d/generations 創建一個 TokenLab 任務；完成狀態響應返回可下載的模型資產，如 model_url，並在可用時返回格式特定的 URL。
選擇輸入類型
在決定要公開哪些選項之前，查詢模型目錄：
此 endpoint 使用輸入類型，而不是
operation 欄位。模型 metadata 會以 text-to-3d 和/或 image-to-3d 表示 3D 能力；3d-generation 不是公開請求 operation。
tripo-h3.1 用於高品質文生/圖生 3D 流程，tripo-p1.0 用於生產級 3D 資產生成。請用 Models API 確認所選模型支援你的輸入類型和輸出格式。
不要假設每個 3D 模型都支持兩種輸入類型或每種輸出格式。在發送 image, image_url, format, quality, style 或 seed 之前，檢查所選模型說明。
創建 3D 任務
image_url。僅在您的客戶端故意發送私有媒體且您的後端準備好處理較大請求主體時，才使用內聯/base64 image。
輸出格式選擇
glb通常是網頁預覽的最安全默認選擇。fbx和obj在所選模型支持時對 DCC 管道很有用。usdz在模型公開時對 Apple AR 工作流程很有用。- 更高的
quality值可能會增加延遲和成本。將它們作為明確的用戶選擇公開，而不是隱藏的默認值。 seed只有在模型尊重它時才對可重現性有用。
輪詢和存儲資產
首先使用返回的poll_url。如果您的客戶端需要固定路由，請使用 GET /v1/tasks/{id}。
model_url，並可能包括 glb_url, fbx_url, obj_url 或 usdz_url。如果用戶需要重複訪問、版本歷史或長期下載，請在您的產品中下載或緩存所選資產。
生產檢查清單
- 持久化
task_id,poll_url, 模型, 請求格式和您自己的資產記錄 ID。 - 在頁面刷新後恢復輪詢，而不是創建重複任務。
- 在創建任務之前驗證源圖像大小和可達性。
- 除非用戶有權訪問資產，否則將生成的資產 URL 保持在公共頁面之外。
- 當存在時記錄
billing_transaction_id以便後續對賬。