AGTCloud API Docs
文件指南API Reference整合與資源更新與幫助
影片生成PixVerse

PixVerse 查詢影片

使用創建介面返回的原生任務 ID 查詢狀態與影片結果。

GET/openapi/v2/video/result/{task_id}

授權

bearerAuth
授權Bearer <token>

使用平台 API Key,格式為 Authorization: Bearer your-api-key。

傳遞位置: header

路徑參數

task_id*string

創建介面返回的 Resp.video_id。保留完整數字,不添加前綴。

比對模式^[0-9]+$

Header 參數

Ai-trace-id?string

可選的唯一追蹤值;未傳由平台生成。不是冪等鍵。

回應主體

application/json

application/json

application/json

application/json

讀取任務狀態

HTTP 200 只表示查詢請求得到響應;先檢查 ErrCode,再檢查 Resp.status。5 為處理中,可每隔 3~5 秒查詢一次;1 為成功,從 Resp.url 讀取影片地址。7 為審核失敗,8 為生成失敗,均應停止原樣輪詢。

請保存完整的原生任務 ID,不要因生成耗時較長而直接重復創建。成功後及時下載或轉存影片。

PixVerse 查詢影片 — 官方文件查看對應的上游協定定義。