Skip to main content

路徑參數

string
必填
從建立影片請求回傳的任務 ID。將 idtask_id 視為相同的非同步識別碼。
如果 create 回應回傳 poll_url,請呼叫該 URL。本當它指向 /v1/tasks/{id} 時,視為固定的標準狀態端點。如果該任務不再存在或無法透過公開的非同步任務協定解析,TokenLab 會回傳 async_task_not_found 並附上訊息 Task not found or no longer available.

回應

string
正規的非同步任務識別符。
string
非同步任務識別符的別名。
string
當建立回應提供時,建議用來輪詢的 URL。
string
當結算已完成時返回 TokenLab 帳單交易 ID。它對應 dashboard / 對帳使用的交易識別,與非同步 id / task_id 不同。
string
任務狀態:pendingprocessingcompletedfailed
number
可選進度值。僅在任務提供真實進度時返回;請使用 status 判斷任務是否完成。
string
產生影片的 URL(完成時)。
object
單一影片資料,當可用時包含 urldurationwidthheight
array
當生成任務回傳多個輸出時的多重影片資料。
string
錯誤訊息(若失敗)。
integer
建立時間戳記。
integer
最後更新時間戳記。
string
任務使用的模型。

輪詢最佳做法

  • 每 5 到 10 秒輪詢一次
  • 對於較長的任務實作指數退避
  • 設定最大逾時(例如:10 分鐘)
  • 優雅地處理 failed 狀態