刪除影片創作任務

更新時間：2026-07-13 11:57:31

介面說明

1、接口支持https协议

介面URL

http://api.polyv.net/live/v4/ai/video-produce/delete

線上API呼叫

請求方式

POST

介面限制

1、介面同時支援HTTP、HTTPS，建議使用HTTPS以確保介面安全，介面呼叫有頻率限制，詳細請查看

URL請求參數說明(用於簽名)

參數名	必填	類型	說明
appId	true	String	帳號appId【詳見取得金鑰】
timestamp	true	Long	目前13位毫秒級時間戳記，3分鐘內有效
sign	true	String	簽名，為32位大寫的MD5值,`產生簽名的appSecret金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料`【詳見簽名產生規則】

body(application/json) 參數說明

參數名	必填	類型	說明
aiPPTVideoId	true	Long	任務ID，僅支援刪除狀態處於20(製作完成)、30(製作失敗)、50(任務過期)的任務

status參數說明

參數值	類型	說明
10	Integer	影片等待製作
15	Integer	影片製作中
20	Integer	影片製作成功
30	Integer	影片製作失敗
50	Integer	影片製作任務已過期

範例

http://api.polyv.net/live/v4/ai/video-produce/delete?timestamp=1716107535043&appId=gopl67qi7e&sign=6625340A6017272DF55CD1F5DC42CFCB

{
    "aiPPTVideoId": 1000
}

回應參數說明

參數名	類型	說明
code	Integer	回應狀態碼，200為成功返回，非200為失敗
status	String	回應結果，由業務決定，成功返回success，失敗返回error
success	Boolean	回應結果，由業務決定，成功返回true，失敗返回false
data	Boolean	刪除成功回應true，失敗請從error參數中取得詳細的失敗資訊
error	Object	狀態碼非200時的錯誤資訊【詳見Error欄位說明】
requestId	String	請求ID，每次請求產生的唯一的 UUID，僅可用於排查、除錯，不應與業務掛鉤

回應範例

成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "e90aba2c69a24bab894c7f708b853b75.71.17161341126309441",
  "data": true,
  "success": true,
  "error": null
}

Error參數說明

參數名	類型	說明
code	Integer	錯誤代碼，用於確定具體的錯誤原因
desc	String	錯誤描述，與 error.code 對應