Skip to main content
將輪詢作為影片生成的基準方式,因為每個非同步工作都會回傳可供查詢的 task ID。只有在所選的影片端點支援 callback URL 時才加入 webhook,並持續將輪詢作為遺漏回呼或處理供應商特定回呼傳送情況的事實來源。

建立影片任務

以下請求會建立一個最小化的影片任務,並儲存回傳的 ID。只有在所選模型頁面有說明這些欄位時,才加入 duration、resolution 或 callback 欄位。
回應會包含 task ID 與狀態:

輪詢狀態

以下請求會檢查影片任務狀態:
回應會隨著任務進度而變化。當模型配接器提供結果 URL 時,完成的回應可能會包含 video_url;否則請使用模型特定的結果欄位,或在該模型支援代理下載時使用 /v1/videos/{id}/content 內容路由。

接收 webhook

CometAPI 並未為每一種影片模型定義單一通用的回呼 payload。請將回呼視為供應商特定的直通事件,儲存原始請求主體,並透過輪詢對齊最終狀態。 以下 Express 處理器會接收影片回呼並儲存事件:
回呼 payload 通常會包含任務識別與狀態欄位,但實際巢狀結構取決於所選模型或供應商:

常見錯誤

相關連結

最後修改於 2026年6月25日