查詢影片任務
輪詢單個影片(及可靈、Midjourney 生圖)任務的狀態與結果位址。
/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)後判失敗。
請求標頭
Bearer sk-…:主控台「API 密鑰」中建立的密鑰,所屬分組須包含請求的模型
路徑參數
提交回傳的任務 ID:vt…(Seedance / Grok)、mmt…(MiniMax)、kt…(可靈)
回傳
200任務物件(含失敗任務)
任務
vt…
模型 ID
只會是這四個值;只在 completed 時讀 outputs
可選值pendingprocessingcompletedfailed
成片秒數;自動時長任務請在完成後讀取
成片位址(字串陣列,不是 {url} 物件);api.hop-base.com 簽名位址,自完成起 24 小時有效,不續期,過期回傳 410
可選,取得末幀時才有;每次查詢重新簽名
可選;是 tokens,不是金額
本次計費 tokens
合計
失敗時 {"message": "<English failure reason>"};連結替換為 [URL_REDACTED]
RFC 3339
未完成時為 null
任務結束後才有,且只對建立任務的密鑰回傳。0 表示失敗且未扣費
本任務扣費的人民幣金額(與 cost_usd 為同一筆扣費)
本任務實際從餘額扣除的美元金額,與使用記錄相同
cost 的幣種,恆為 CNY
mmt… / kt…
queued → processing → completed | failed;只有後兩者是終態,其他值按進行中處理
成片位址;自完成起 24 小時有效,不續期,過期回傳 410
失敗原因;可靈帶穩定的 error.code(如 input_sensitive、generation_failed)
英文說明
僅可靈
計費明細 + 扣費金額
MiniMax 計費檔位
MiniMax 計費秒數
MiniMax 參考影片輸入秒數
MiniMax 超出免費額度的參考圖張數
本任務扣費的人民幣金額(與 cost_usd 為同一筆扣費)
本任務實際從餘額扣除的美元金額,與使用記錄相同
cost 的幣種,恆為 CNY
錯誤
missing_api_key / invalid_api_key / api_key_expired)