调用CreateUploadStream获取媒体流上传地址和凭证_智能媒体服务(IMS)-阿里云帮助中心

获取媒体流上传地址和凭证。

接口说明

本接口用于本地上传媒体流，上传完成之后会将该媒体流挂载到指定的 MediaId 下。
本接口仅支持上传至 VOD 点播存储，不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户，可以先通过OSS SDK上传文件至 OSS，再调用 RegisterMediaStream 接口将媒体流挂载到指定媒资。
本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）地域。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
MediaId	string	否	媒资 ID。	**20b48fb04483915d4f2cd8ac**
Definition	string	否	视频流清晰度定义。取值： FD：流畅。 LD：标清。 SD：高清。 HD：超清 OD：原画。 2K：2K。 4K：4K。 SQ：普通音质。 HQ：高音质。	HD
FileExtension	string	否	媒体文件扩展名。	MP4
HDRType	string	否	转码流 HDR 类型。取值： HDR HDR10 HLG DolbyVision HDRVivid SDR+ 说明大小写不敏感。非 HDR 视频该参数为空即可。	HDR10
UserData	string	否	用户自定义参数。	{"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	****11-DB8D-4A9A-875B-275798****
MediaId	string	媒资 ID。	**c469e944b5a856828dc2**
FileURL	string	文件 OSS 地址（不带鉴权）。	http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
UploadAddress	string	上传地址。说明接口返回的上传地址是 Base64 加密后的值。调用 SDK 或 API 完成媒资上传时需要对其进行 Base64 解码后再使用。仅 OSS 原生 SDK 或 OSS API 方式上传需要自行解析 UploadAddress。	eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****
UploadAuth	string	上传凭证。说明接口返回的上传凭证是 Base64 加密后的值。调用 SDK 或 API 完成媒资上传时需要对其进行 Base64 解码后再使用。仅 OSS 原生 SDK 或 OSS API 方式上传需要自行解析 UploadAuth。	eyJFbmRwb2ludCI6Imm****

示例

正常返回示例

JSON格式

{
  "RequestId": "******11-DB8D-4A9A-875B-275798******",
  "MediaId": "****c469e944b5a856828dc2****",
  "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
  "UploadAddress": "eyJTZWN1cml0a2VuIjoiQ0FJU3p3TjF****",
  "UploadAuth": "eyJFbmRwb2ludCI6Imm****"
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史