调用UploadMediaByURL基于URL拉取音视频文件上传_智能媒体服务-阿里云帮助中心

调用UploadMediaByURL基于源文件URL，拉取音视频媒体文件进行上传，支持批量上传。

接口说明

如果配置了回调，则上传完成后会收到URL上传视频完成的事件通知，可以通过获取URL上传信息接口查询上传状态。
上传任务提交成功后，会在云端生成异步执行的任务，进行排队执行；上传完成后可根据事件通知（消息回调）返回的URL和视频ID等信息进行关联。
本接口主要适用于文件没有存储在本地服务器或终端，需要通过公网访问的URL地址上传的场景。
本接口仅支持上传至VOD点播存储，不支持上传至用户自有OSS存储。使用自有OSS存储的用户，可以先将文件拉取到本地，通过OSS SDK上传文件至OSS，然后再调用RegisterMediaInfo接口将OSS文件注册至媒资库。
本接口目前仅支持华东2（上海）、华北2（北京）、华南1（深圳）地域。

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
UploadURLs	string	否	媒体源文件URL。 URL中需要包括扩展名, 比如`https://****.mp4`中mp4为扩展名。如果URL中不包含扩展名，可以在`UploadMetadatas`中传入`FileExtension`来指定。如果URL中有扩展名且同时传入`FileExtension`，以传入的`FileExtension`为准。 URL编码，多个地址之间以半角逗号（,）分隔，最多支持20个。避免存在特殊字符导致无法上传视频，需要URL编码后再做逗号拼接。	https://diffurl.mp4
AppId	string	否	应用ID。	app-1000000
UserData	string	否	自定义设置。为JSON字符串，支持消息回调等设置。	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
UploadTargetConfig	string	否	目标存储地址。 StorageType 取值：仅支持oss。 StorageLocation 仅支持VOD点播存储，不支持用户自有OSS存储。	{"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
MediaMetaData	string	否	上传媒体文件的元数据信息，为JSON字符串。与UploadURLs里的URL匹配才能生效。 JSON格式：[UploadMetadata, UploadMetadata,…]，需转为JSON字符串。更多信息，请参见下表UploadMetadata。	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
PostProcessConfig	string	否	Type = video \|\| audio 有上传后处理动作。 ProcessType取值：Workflow。	{"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
EntityId	string	否	实体 ID。可调用CreateEntity接口创建实体，自定义动态元数据结构。	d67281da3c8743b8823ad12976187***

UploadMetadata

名称	类型	是否必需	描述
SourceURL	String	是	需要上传的媒体源文件URL。
Title	String	是	媒体标题。长度不超过128个字节。UTF-8编码。
FileSize	String	否	文件大小。
Description	String	否	描述。长度不超过1024个字节。UTF-8编码。
CoverURL	String	否	自定义视频封面URL地址。
CateId	String	否	分类ID。
Tags	String	否	标签。单个标签不超过32字节，最多不超过16个标签。多个标签，请使用半角逗号（,）分隔。UTF8编码。
WorkflowId	String	否	工作流ID。
FileExtension	String	否	媒体文件扩展名。
DynamicMetaData	String	否	动态元数据，例："{"Uploader": "xxx"}"。
FileExtension	String	否	实体Id。

说明

UploadMetadata 中的参数（如Title、Description、Tags等）不能包含表情符。

如果配置了回调，视频上传完成后，除了上传和转码通知，还有URL上传视频完成件通知。

批量提交时，每一个SourceURL有独立的通知。

返回参数

名称	类型	描述	示例值
	object	返回结果。
RequestId	string	请求ID。	**83B7-7F87-4792-BFE9-63CD2137**
UploadJobs	array	多个Job信息。
	object	上传任务详情。
JobId	string	上传任务ID。	20ce1e05dba64576b96e9683879f0***
SourceURL	string	上传任务对应的源文件URL。	http://example****.mp4
MediaId	string	媒资ID。	f476988629f54a7b8a4ba90d1a6c7***

示例

正常返回示例

JSON格式

{
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "UploadJobs": [
    {
      "JobId": "20ce1e05dba64576b96e9683879f0***",
      "SourceURL": "http://example****.mp4\n",
      "MediaId": "f476988629f54a7b8a4ba90d1a6c7***"
    }
  ]
}

错误码

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