# 媒资上传

上传时需要注意以下事项:

  1. 首次上传要初始化资源,需要一定时间,在初始化期间上传都会返回失败(错误码为 -2),等待一段时间(一般为几分钟)后重试即可。
  2. 需按照“剧目名 - 对应剧集数”格式命名文件(如:“我的演艺 - 第1集”)。
  3. 视频格式支持:MP4,TS,MOV,MXF,MPG,FLV,WMV,AVI,M4V,F4V,MPEG,3GP,ASF,MKV。如需上传 m3u8 视频,请使用"拉取上传"接口。
  4. 图片格式支持:JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF。
  5. 如果接口返回 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