# 媒资上传
上传时需要注意以下事项:
- 首次上传要初始化资源,需要一定时间,在初始化期间上传都会返回失败(错误码为 -2),等待一段时间(一般为几分钟)后重试即可。
- 需按照“剧目名 - 对应剧集数”格式命名文件(如:“我的演艺 - 第1集”)。
- 视频格式支持:MP4,TS,MOV,MXF,MPG,FLV,WMV,AVI,M4V,F4V,MPEG,3GP,ASF,MKV。如需上传 m3u8 视频,请使用"拉取上传"接口。
- 图片格式支持:JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF。
- 如果接口返回 HTTP 状态码 502,请检查上传的文件是否超过了特定接口所限制的大小。
| 接口名称 | 请求路径 | 描述 |
|---|---|---|
| 单个文件上传 | /wxa/sec/vod/singlefileupload | 该接口用于上传媒体(和封面)文件,上传小文件(小于10MB)时使用 |
| 拉取上传 | /wxa/sec/vod/pullupload | 该接口用于将一个网络上的视频拉取上传到平台 |
| 查询任务 | /wxa/sec/vod/gettask | 该接口用于查询拉取上传的任务状态 |
| 申请分片上传 | /wxa/sec/vod/applyupload | 上传大文件时需使用分片上传方式,分为 3 个步骤: |
| 上传分片 | /wxa/sec/vod/uploadpart | 将文件的其中一个分片上传到平台,最多支持100个分片,每个分片大小为5MB,最后一个分片可以小于5MB |
| 确认上传 | /wxa/sec/vod/commitupload | 该接口用于完成整个分片上传流程,合并所有文件分片,确认媒体文件(和封面图片文件)上传到平台的结果,返回文件的 ID |