UploadMediaByURL_视频点播_API调试-阿里云OpenAPI开发者门户

接口说明

请确保在使用该接口前，已充分了解视频点播产品的收费方式和价格。媒资文件上传到视频点播中会产生存储费用，计费详情，请参见媒资存储计费。如果您已开通了存储传输加速，则上传媒资文件到视频点播时还将涉及上传加速费用，计费详情请参见存储传输加速计费。
本接口支持上传的媒体文件格式，请参见媒体格式。
本接口主要适用于文件没有存储在本地服务器或终端，需要通过公网访问的 URL 地址上传的场景。
本接口为异步上传接口，非实时，不保证时效性，一般提交后会在数小时、甚至数天内完成迁移上传。如果对时效性要求较高，建议使用上传 SDK 上传。
如果配置了回调，则上传完成后会收到 URL 上传视频完成的事件通知，可以通过获取 URL 上传信息接口查询上传状态。
上传任务提交成功后，会在云端生成异步执行的任务，相应服务地域下所有用户提交的 URL 上传任务进行排队执行，完成时间受已有任务数量影响；上传完成后可根据事件通知（消息回调）返回的 URL 和视频 ID 等信息进行关联。
本接口目前仅支持华东 2（上海）、华北 2（北京）、华南 1（深圳）、新加坡、美国（硅谷）地域。
同一个媒体文件 URL，每次提交上传任务都会在点播中产生一个新的媒体资源（即产生新的媒体 ID）。

请求参数

字段名称	字段详情
UploadURLsstring	媒体源文件 URL。展开详情示例值:https://****.mp4参考取值来源: GetURLUploadInfos
TemplateGroupIdstring	转码模板组 ID。可通过以下方式获取：展开详情示例值:ca3a8f6e4957b65806709586****参考取值来源: AddTranscodeTemplateGroup ListTranscodeTemplateGroup UpdateTranscodeTemplateGroup
StorageLocationstring	媒体文件存储地址。展开详情示例值:outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com参考取值来源: AddVodStorageForApp
UploadMetadatasstring	上传媒体文件的元数据信息，为 JSON 字符串。展开详情示例值:[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
UserDatastring	自定义设置。为 JSON 字符串，支持消息回调、上传加速等设置。更多信息，请参见 UserData 。展开详情示例值:{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
AppIdstring	应用 ID。默认取值：app-1000000。更多信息，请参见多应用。示例值:app-****参考取值来源: ListAppInfo CreateAppInfo
WorkflowIdstring	工作流 ID。可登录点播控制台，选择配置管理 > 媒体处理配置 > 工作流管理查看工作流 ID。展开详情示例值:e1e243b42548248197d6f74f9****
SessionIdstring	自定义去重识别码，如果传递了该参数请求，当检测到在过去 10 分钟内曾有过相同识别码的请求，则会在本次请求时返回错误。展开详情示例值:5c62d40299034bbaa4c195da330****

请求说明

UploadMetadata

名称	类型	是否必需	描述
SourceURL	String	是	需要上传的媒体源文件 URL。
Title	String	否	媒体标题。长度不超过 128 个字节。UTF-8 编码。
FileSize	String	否	文件大小。
Description	String	否	描述。长度不超过 1024 个字节。UTF-8 编码。
CoverURL	String	否	自定义视频封面 URL 地址。
CateId	String	否	分类 ID。可通过登录点播控制台，选择配置管理 > 媒资管理配置 > 分类管理查看分类 ID。
Tags	String	否	标签。单个标签不超过 32 字节，最多不超过 16 个标签。多个标签，请使用半角逗号（,）分隔。UTF8 编码。
TemplateGroupId	String	否	转码模板组 ID。会覆盖外层传入的 TemplateGroupId。
WorkflowId	String	否	工作流 ID。如果同时传入了 WorkflowId 和 TemplateGroupId，以 WorkflowId 为准。更多信息，请参见工作流。
FileExtension	String	否	媒体文件扩展名，支持的扩展名，请参见上传概述。

说明

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

为确保正常播放，当 TemplateGroupId 设置为“VOD_NO_TRANSCODE”不转码的方式上传视频文件后，目前仅以下格式的文件支持不转码直接播放：MP4、FLV、MP3、M3U8、WEBM，其他格式仅支持存储（关注 FileName 的扩展名）。若使用阿里云播放器，版本须为 3.1.0 或以上。

指定不转码的模板组（TemplateGroupId 设置为“VOD_NO_TRANSCODE”），视频上传后仅有视频上传完成的事件通知，没有单个清晰度转码完成的事件通知。

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

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

返回参数

字段名称	字段详情
RequestIdstring	请求 ID。示例值:25818875-5F78-4AF6-D7393642CA58****
UploadJobsarray<object>	上传任务列表。

变更历史

暂无变更历史