基于源文件URL,拉取音视频媒体文件进行上传,支持批量上传。
接口说明
- 请确保在使用该接口前,已充分了解视频点播产品的收费方式和价格。媒资文件上传到视频点播中会产生存储费用,计费详情,请参见媒资存储计费。如果您已开通了存储传输加速,则上传媒资文件到视频点播时还将涉及上传加速费用,计费详情请参见存储传输加速计费。
- 本接口支持上传的媒体文件格式,请参见媒体格式。
- 本接口主要适用于文件没有存储在本地服务器或终端,需要通过公网访问的 URL 地址上传的场景。
- 本接口为异步上传接口,非实时,不保证时效性,一般提交后会在数小时、甚至数天内完成迁移上传。如果对时效性要求较高,建议使用上传 SDK 上传。
- 如果配置了回调,则上传完成后会收到 URL 上传视频完成的事件通知,可以通过获取 URL 上传信息接口查询上传状态。
- 上传任务提交成功后,会在云端生成异步执行的任务,相应服务地域下所有用户提交的 URL 上传任务进行排队执行,完成时间受已有任务数量影响;上传完成后可根据事件通知(消息回调)返回的 URL 和视频 ID 等信息进行关联。
- 本接口目前仅支持华东 2(上海)和新加坡地域。
- 同一个媒体文件 URL,每次提交上传任务都会在点播中产生一个新的媒体资源(即产生新的媒体 ID)。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
下表是API对应的授权信息,可以在RAM权限策略语句的Action
元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:
- 操作:是指具体的权限点。
- 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
- 资源类型:是指操作中支持授权的资源类型。具体说明如下:
- 对于必选的资源类型,用背景高亮的方式表示。
- 对于不支持资源级授权的操作,用
全部资源
表示。
- 条件关键字:是指云产品自身定义的条件关键字。
- 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作 | 访问级别 | 资源类型 | 条件关键字 | 关联操作 |
---|---|---|---|---|
vod:UploadMediaByURL | Write |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
UploadURLs | string | 是 | 媒体源文件 URL。
| https://****.mp4 |
TemplateGroupId | string | 否 | 转码模板组 ID。可通过以下方式获取:
说明
UploadMetadatas 中进行设置,如果在 UploadMetadatas 中设置了 TemplateGroupId,此处也设置了 TemplateGroupId,则以 UploadMetadatas 中设置的 TemplateGroupId 为准。 | ca3a8f6e4957b65806709586**** |
StorageLocation | string | 否 | 媒体文件存储地址。 登录点播控制台,选择配置管理 > 媒资管理配置 > 存储管理查看存储地址。不指定时会使用默认存储地址。 | outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com |
UploadMetadatas | string | 否 | 上传媒体文件的元数据信息,为 JSON 字符串。
| [{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}] |
UserData | string | 否 | {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}} | |
AppId | string | 否 | 应用 ID。默认取值:app-1000000。 更多信息,请参见多应用。 | app-**** |
WorkflowId | string | 否 | e1e243b42548248197d6f74f9**** | |
SessionId | string | 否 | 自定义去重识别码,如果传递了该参数请求,当检测到在过去 10 分钟内曾有过相同识别码的请求,则会在本次请求时返回错误。 该去重识别码由您自定义设置,长度最长为 50 个字符,支持大小写英文字母、数字、短划线(-)和下划线(_),不传或者带空字符串表示不去重。 | 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 有独立的通知。
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58****",
"UploadJobs": [
{
"SourceURL": "http://example****.mp4",
"JobId": "ad90a501b1b94fb72374ad005046****"
}
]
}
错误码
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 |
---|---|---|
2023-05-16 | OpenAPI 入参发生变更 | 查看变更详情 |