跳到正文

查詢影片任務

輪詢單個影片(及可靈、Midjourney 生圖)任務的狀態與結果位址。

GET/v1/video/tasks/{task_id}

用提交時回傳的任務 ID 輪詢,建議每 5 秒一次;輪詢不佔並行、不計費。Seedance / Grok 回應用 task 包裝,MiniMax / 可靈是頂層欄位——不要讀錯層級。

Seedance 任務建立超過 24 小時仍未結束會被自動判為失敗(不計費),task.error.message 為 The task did not finish within 24 hours and was terminated automatically。結果位址是 api.hop-base.com 下的簽名位址,再次查詢回傳同一位址、不會續期:所有結果連結(Seedance、Grok、可靈、MiniMax 一致)自任務完成起 24 小時內有效,請及時下載儲存。未完成的任務 24 小時(Seedance)或 2 小時(可靈、MiniMax)後判失敗。

請求標頭

Authorization:必填string

Bearer sk-…:主控台「API 密鑰」中建立的密鑰,所屬分組須包含請求的模型

路徑參數

task_id:必填string

提交回傳的任務 ID:vt…(Seedance / Grok)、mmt…(MiniMax)、kt…(可靈)

回傳

200任務物件(含失敗任務)

系列
task:選填object

任務

usage:選填object

任務結束後才有,且只對建立任務的密鑰回傳。0 表示失敗且未扣費

錯誤

401沒帶密鑰、密鑰無效或已過期(missing_api_key / invalid_api_key / api_key_expired)
404任務不存在或不屬於這把密鑰

相關頁面