UploadMediaByURL
基于源文件URL，拉取音视频媒体文件进行上传，支持批量上传。本接口主要适用于文件没有存储在本地服务器或终端，需要通过公网访问的URL地址上传的场景
服务地址：
华东1（杭州）
输入参数
只看必填
UploadURLs媒体源文件URL
AppId应用ID
UserData自定义设置
UploadTargetConfig目标存储地址
MediaMetaData上传媒体文件的元数据信息
PostProcessConfigType = video || au...
EntityId实体 ID
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

  • 如果配置了回调，则上传完成后会收到 URL 上传视频完成的事件通知，可以通过获取 URL 上传信息接口查询上传状态。
  • 上传任务提交成功后，会在云端生成异步执行的任务，进行排队执行；上传完成后可根据事件通知（消息回调）返回的 URL 和视频 ID 等信息进行关联。

使用限制

  • 本接口仅支持上传至 VOD 点播存储，不支持上传至用户自有 OSS 存储。使用自有 OSS 存储的用户，可以先将文件拉取到本地，通过OSS SDK上传文件至 OSS，然后再调用 RegisterMediaInfo 接口将 OSS 文件注册至媒资库。

  • 本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）地域。

  • 本接口仅支持上传音视频文件。

请求参数

字段名称字段详情
UploadURLsstring

媒体源文件 URL。展开详情

示例值:https://diffurl.mp4参考取值来源:
    GetUrlUploadInfos
AppIdstring

应用 ID。

示例值:app-1000000
UserDatastring

自定义设置。为 JSON 字符串，支持消息回调等设置。

示例值:{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
UploadTargetConfigstring

目标存储地址。展开详情

示例值:{"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
MediaMetaDatastring

上传媒体文件的元数据信息，为 JSON 字符串。展开详情

示例值:[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
PostProcessConfigstring

Type = video || audio 有上传后处理动作。展开详情

示例值:{"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
EntityIdstring

实体 ID。可调用 CreateEntity 接口创建实体，自定义动态元数据结构。

示例值:d67281da3c8743b8823ad12976187***

请求说明

UploadMetadata

名称类型是否必需描述
SourceURLString是需要上传的媒体源文件 URL。
TitleString是媒体标题。长度不超过 128 个字节。UTF-8 编码。
FileSizeString否文件大小。
DescriptionString否描述。长度不超过 1024 个字节。UTF-8 编码。
CoverURLString否自定义视频封面 URL 地址。
CateIdString否分类 ID。
TagsString否标签。单个标签不超过 32 字节，最多不超过 16 个标签。多个标签，请使用半角逗号（,）分隔。UTF8 编码。
WorkflowIdString否工作流 ID。
FileExtensionString否媒体文件扩展名。
DynamicMetaDataString否动态元数据，例："{"Uploader": "xxx"}"。
EntityIdString否实体 Id。
说明
  • UploadMetadata 中的参数（如 Title、Description、Tags 等）不能包含表情符。
  • 如果配置了回调，视频上传完成后，除了上传和转码通知，还有 URL 上传视频完成件通知。
  • 批量提交时，每一个 SourceURL 有独立的通知。
    •

    返回参数

    字段名称字段详情
    RequestIdstring

    请求 ID。

    示例值:****83B7-7F87-4792-BFE9-63CD2137****
    UploadJobsarray<object>

    多个 Job 信息。

    变更历史
    暂无变更历史