UploadMediaByURL_智能媒体生产_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
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
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(深圳)地域。

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

流控信息

当前云产品API请求速率暂未透出。

授权信息

当前云产品暂无权限信息透出。

请求参数

字段名称字段详情
UploadURLsstring

媒体源文件 URL。展开详情

示例值:https://diffurl.mp4
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 信息。

    返回示例

    变更历史

    变更时间变更内容概要操作
    2022-06-20
    新增OpenAPI,URL拉取上传

    相关示例

    URL拉取上传
    2024-02-19