非同步上傳用於影片創作的PPT

更新時間：2026-06-12 10:49:48

介面說明

1、异步上传制课ppt, 调用接口后，直接返回结果，异步获取ppt并上传
2、可通过回调或调用查询视频创作任务接口获取上传状态及转码解析结果, 转码完成后即可将该ppt用于视频创作
3、接口支持https协议
4、支持200M以内ppt大文件上传

介面URL

https://api.polyv.net/live/v4/ai/video-produce/ppt/async-upload

請求方式

POST

介面限制

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

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

參數名	必填	類型	說明
appId	true	String	帳號appId【詳見取得金鑰】
timestamp	true	Long	目前13位毫秒級時間戳，3分鐘內有效
sign	true	String	簽名，為32位大寫的MD5值，`產生簽名的appSecret金鑰作為通訊資料安全的關鍵資訊，嚴禁儲存在用戶端直接使用，所有API都必須透過客戶自己伺服器中轉呼叫POLYV伺服器取得回應資料`【詳見簽名產生規則】
url	true	String	PPT檔案URL位址(僅支援ppt、pptx格式的文件連結，檔案最大支援200M)
docName	false	String	自訂PPT檔案名稱（不傳則取URL位址上的檔案名稱）
type	false	String	轉換類型，不傳預設為普通，取值如下： `common` - 普通 `animate` - 動畫PPT
callbackUrl	false	String	回呼位址，轉碼完成後會回呼該位址通知結果
childUserId	false	String	直播子帳號使用者ID，用於實現子帳號之間PPT資料隔離

回應參數說明

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

data參數說明

參數名	類型	說明
fileId	String	檔案ID，請注意保利威對於內容完全相同的PPT檔案，不會重複建立PPT轉碼解析任務，如您使用同一份PPT重複上傳，返回的fileId是一樣的（透過查詢用於影片創作的PPT介面可以取得PPT文件狀態）

回應範例

成功範例

{
  "code": 200,
  "status": "success",
  "requestId": "e90aba2c69a24bab894c7f708b853b75.72.17161066775207261",
  "data": {
    "fileId": "22d1a1586dc04382685996bc227bfb44c560fac50fpptVideocommon"
  },
  "success": true
}

Error參數說明

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

回呼說明

PPT上傳失敗或轉換結果即時資訊回呼，可以及時通知使用者上傳、轉換任務的結果。

原理

透過HTTP介面（設定的callbackUrl）向使用者伺服器發送GET請求，將合併結果推送給使用者伺服器。

舉例說明

舉例如下：http://abc.com/test.do?status=normal&timestamp=1603506240000&fileId=xxx&sign=xxdxxxxx

參數名	類型	說明
status	String	檔案轉換狀態（"normal"：正常，"failConvert"：轉換PPT失敗，"failUpload"：上傳PPT失敗）
fileId	String	檔案ID，成功時返回
timestamp	Long	13位毫秒級時間戳
sign	String	校驗的加密字串，產生的規則md5(fileId+timestamp)