跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

輪詢此端點以檢查您的 3D 模型生成任務狀態。
如果建立回應中包含 poll_url，請優先直接呼叫該 URL 輪詢。id 與 task_id 應視為同一個非同步任務身分。如果該任務已不存在，或無法再透過公開的 async-task 合約解析，TokenLab 會回傳 async_task_not_found，並附上訊息 Task not found or no longer available.

​
路徑參數

​
id
string
必填
3D 生成任務 ID。

​
回應

​
id
string
任務 ID。
​
task_id
string
可用時返回的非同步任務 ID 別名。
​
status
string
任務狀態：pending、processing、completed 或 failed。
​
progress
integer
進度百分比 (0-100)。
​
model_url
string
下載 3D 模型檔案的 URL（完成時）。
​
glb_url
string
下載 GLB 格式模型的 URL（可用時）。
​
fbx_url
string
下載 FBX 格式模型的 URL（可用時）。
​
error
string
錯誤訊息（失敗時）。
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"
}