当媒体文件为网络文件或需要自动化上传、大批量迁移时,可以通过调用智能媒体服务相关接口获取媒资上传地址和凭证,再调用OSS原生接口完成上传功能。通过阅读本文,您可以了解基于OSS API上传的方法。

前提条件

背景信息

调用OSS API进行媒资上传前,您需要获取媒资上传地址和凭证。上传地址是指智能媒体服务中OSS的存储地址,上传凭证是完成上传动作的授权凭证。上传地址和凭证均由智能媒体服务下发,主要解决媒体上传过程中的授权和安全问题,防止恶意上传。同时,智能媒体服务在下发上传地址和凭证时会自动创建媒资信息,即媒资ID,可用于后续媒资生命周期管理或媒体处理。

注意事项

  • 单个音视频文件大小最大支持5 GB。
  • 上传时文件的扩展名大小写不敏感,如果上传时扩展名不支持(即格式不支持,和上传凭证不匹配),不支持的文件会上传失败。

步骤一:获取上传地址和凭证

通过集成服务端SDK(推荐)或自建HTTP(S)请求后调用接口CreateUploadMedia,获取媒资上传地址和凭证。更多信息,请参见安装服务端SDKRPC 调用机制

重要
  • 单个上传地址和凭证只能用于单个媒资,不能混用,否则会造成覆盖。
  • 对于单个媒资文件重复获取上传地址和凭证时,前后获取到上传地址和凭证不同。
  • 上传地址由智能媒体服务自动分配,暂不支持自定义。
  • 上传凭证有效时间为3000秒,如果视频文件较大,上传过程中凭证可能会失效,需要调用RefreshUploadMedia刷新上传凭证,刷新后新的凭证有效期仍为3000秒,且上传地址不变。
  • 图片、辅助媒资(字幕、字体文件)文件较小,凭证失效后需要重新获取。

步骤二:调用OSS API上传媒资

通过Base64解码上传地址和凭证后,调用OSS上传相关的API,进行媒资上传。更多信息,请参见公共HTTP头定义上传文件至OSS

API参考