调用UploadStreamByURL拉取媒体流文件进行上传_智能媒体服务(IMS)-阿里云帮助中心

调用UploadStreamByURL基于源文件URL，拉取媒体流文件进行上传。

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
StreamURL	string	否	转码流文件 URL。如果转码流的 URL 需要鉴权，需要在 StreamURL 中传入鉴权参数，并确保该 URL 可以通过公网访问。	https://example.com/sample-stream.mp4
MediaId	string	否	媒资 ID。	411bed50018971edb60b0764a0ec6***
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://test.test.com"}, "Extend":{"localId":"xxx","test":"www"}}

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求 ID。	****89-C21D-4B78-AE24-3788B8****
JobId	string	上传任务 ID。	**cdb3e74639973036bc84**
MediaId	string	媒资 ID。	411bed50018971edb60b0764a0ec6***
FileURL	string	文件 OSS 地址。	http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4
SourceURL	string	上传任务对应的源文件 URL。	https://example.com/sample-stream.mp4

示例

正常返回示例

JSON格式

{
  "RequestId": "******89-C21D-4B78-AE24-3788B8******",
  "JobId": "****cdb3e74639973036bc84****",
  "MediaId": "411bed50018971edb60b0764a0ec6***",
  "FileURL": "http://outin-***.oss-cn-shanghai.aliyuncs.com/stream/48555e8b-181dd5a8c07/48555e8b-181dd5a8c07.mp4",
  "SourceURL": "https://example.com/sample-stream.mp4"
}

错误码

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

变更历史

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

暂无变更历史