# 媒资上传

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

1. 首次上传要初始化资源，需要一定时间，在初始化期间上传都会返回失败（错误码为 -2），等待一段时间（一般为几分钟）后重试即可。
2. 需按照“剧目名 - 对应剧集数”格式命名文件（如：“我的演艺 - 第1集”）。
3. 视频格式支持：MP4，TS，MOV，MXF，MPG，FLV，WMV，AVI，M4V，F4V，MPEG，3GP，ASF，MKV。如需上传 m3u8 视频，请使用"[拉取上传](api_pullupload)"接口。
4. 图片格式支持：JPG、JPEG、PNG、BMP、TIFF、AI、CDR、EPS、TIF。
5. 如果接口返回 HTTP 状态码 502，请检查上传的文件是否超过了特定接口所限制的大小。

```json
[
  {
    "接口名称": "[单个文件上传](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_singlefileupload)",
    "请求路径": "/wxa/sec/vod/singlefileupload",
    "描述": "该接口用于上传媒体（和封面）文件，上传小文件（小于10MB）时使用"
  },
  {
    "接口名称": "[拉取上传](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_pullupload)",
    "请求路径": "/wxa/sec/vod/pullupload",
    "描述": "该接口用于将一个网络上的视频拉取上传到平台"
  },
  {
    "接口名称": "[查询任务](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_gettask)",
    "请求路径": "/wxa/sec/vod/gettask",
    "描述": "该接口用于查询拉取上传的任务状态"
  },
  {
    "接口名称": "[申请分片上传](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_applyupload)",
    "请求路径": "/wxa/sec/vod/applyupload",
    "描述": "上传大文件时需使用分片上传方式，分为 3 个步骤："
  },
  {
    "接口名称": "[上传分片](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_uploadpart)",
    "请求路径": "/wxa/sec/vod/uploadpart",
    "描述": "将文件的其中一个分片上传到平台，最多支持100个分片，每个分片大小为5MB，最后一个分片可以小于5MB"
  },
  {
    "接口名称": "[确认上传](/miniprogram/dev/server/API/minidrama/vod_fileupload/api_commitupload)",
    "请求路径": "/wxa/sec/vod/commitupload",
    "描述": "该接口用于完成整个分片上传流程，合并所有文件分片，确认媒体文件（和封面图片文件）上传到平台的结果，返回文件的 ID"
  }
]
```