3D
獲取 3D 模型狀態
獲取 3D 生成任務的狀態與結果
輪詢此端點以檢查您的 3D 模型生成任務狀態。
如果建立回應中包含 poll_url，請優先直接呼叫該 URL 輪詢。id 與 task_id 應視為同一個非同步任務身分。
已過期或不可用的公開任務可能回傳 404 async_task_not_found。無法確認目前 API 金鑰對任務的歸屬權限時，回傳 403 task_not_owned。
路徑參數
idstringpath必填
3D 生成任務 ID。
回應
結果、錯誤、時間戳記與模型欄位僅在任務提供時回傳。
idstring
任務 ID。
task_idstring
可用時返回的非同步任務 ID 別名。
poll_urlstring
可用時返回的優先輪詢 URL。
statusstring
任務狀態：pending、processing、completed 或 failed。
progressinteger
可選進度值。僅在任務提供真實進度時返回；請使用 status 判斷任務是否完成。
model_urlstring
下載 3D 模型檔案的 URL（完成時）。
glb_urlstring
下載 GLB 格式模型的 URL（可用時）。
fbx_urlstring
下載 FBX 格式模型的 URL（可用時）。
errorstring | object
錯誤訊息（失敗時）。
請求
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"回應
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://cdn.tripo3d.ai/abc123.glb",
"glb_url": "https://cdn.tripo3d.ai/abc123.glb",
"fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}授權
BearerAuth AuthorizationBearer <token>
API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
路徑參數
id*string
由 id / task_id 回傳，或嵌入於 poll_url 中的非同步任務 ID
回應
application/json
application/json
application/json
application/json