异步上传用于视频创作的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)

直播服务端 API