概覽
使用此端點對影片、影像、音樂與 3D 生成等任務類型進行統一的非同步輪詢。 如果建立回應包含poll_url，請呼叫該精確路徑。某些影像模型可能會在影像專用的狀態路徑或 /v1/tasks/{id} 下回傳基於任務的回應。
路徑參數
string
必填
由建立請求返回的任務 ID。
回應
string
標準的非同步任務識別碼。
string
非同步任務識別符別名。
string
當建立回應提供時，首選的輪詢 URL。
string
任務狀態，例如
pending、processing、completed 或 failed。已取消的任務會表示為 failed 並帶有 cancelled: true。boolean
排隊中的非同步任務在執行前被取消時為
true。string
取消標記。取消成功時為
cancelled。array
對於已完成的圖片任務，生成的圖片結果會在這裡返回。圖片任務會在
data[].url 中返回 URL。number
可選進度值。僅在任務提供真實進度時返回；請使用
status 判斷任務是否完成。string
任務完成並產生影片時的結果資產 URL。
object
單一影片載荷，包含
url、duration、width 與 height（若可用）。array
存在多於一個輸出時的多個影片載荷。
string
任務失敗時的錯誤訊息。
integer
可用時的建立時間戳。
integer
可用時的最後更新時間戳。
string
可用時任務使用的模型。
錯誤行為
如果任務不再存在、已過期，或無法再從公開任務記錄中查詢到，TokenLab 會回傳：範例
Python
JavaScript