文件影片狀態
影音
GET /unified-video/:taskId/status
當你需要手動查詢、fallback 或補救流程時，用這支 API 查影片任務狀態。
GET /unified-video/:taskId/status權限: api.generate
適合情境
要做歷史頁、進度追蹤與結果狀態的團隊。
手動查詢
fallback 檢查
完成與失敗狀態
怎麼呼叫
json
{
"model": "hailuo-2.3-standard",
"prompt": "讓人像照片產生自然的呼吸與眨眼動作",
"images": [
"https://example.com/portrait.png"
],
"duration": 10,
"resolution": "768P"
}這支 API 是做什麼的
主流程應以 callback 或 webhook 接收完成結果。
這支 API 比較適合手動查詢、fallback 或 callback 補救流程，而不是預設就一直輪詢。
參數說明
taskId
必填 path 參數。來自 /unified-video/generate 回傳的 taskId。
Response 欄位
success
查詢是否成功。
taskId
目前查詢的任務 id。
status
目前任務狀態。
output / assets
若已完成，則為生成結果。
error
若失敗，則提供失敗資訊。
前端怎麼用
- 把原始 status 轉成客戶看得懂的字。
- 若需要手動查詢時，再在歷史區塊顯示進度。
- 若失敗，要提供清楚的下一步。
想直接開始測試？
先到 Settings 建立 general API key，再回到這裡直接複製請求範例。