CreateMediaConvertTask_智能媒体管理_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.

接口说明

  • 请确保在使用该接口前,已充分了解智能媒体管理产品的收费方式和价格
  • 调用该接口前,请确保当前 Region 已经存在可用的项目(Project),详见项目管理
    注意 异步任务不保证时效。
  • 使用该接口进行媒体转码时,默认只处理一路视频/音频/字幕流,同时支持配置处理的视频/音频/字幕流数量。
  • 使用该接口进行媒体拼接时,最大支持的媒体数量为 11 个,此时配置的转码、截帧等参数将作用于拼接后媒体数据。
  • 该接口为异步接口,获取任务开始执行后,任务信息只保存 7 天,超过 7 天则无法再获取。调用 GetTaskListTasks 接口获取返回的TaskId,查看任务信息。也可以通过设置 Notification 消息通知参数,通过消息通知获取任务信息。

流控信息

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

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
imm:CreateMediaConvertTask
Create
Project
acs:imm:{#regionId}:{#accountId}:project/{#ProjectName}

请求参数

字段名称字段详情
ProjectNamestring

项目名称,获取方式请参见创建项目

示例值:test-project参考取值来源:
    CreateProject
    UpdateProject
    ListProjects
Sourcesarray<object>

媒体文件列表。若列表元素大于 1 个则表示开启 Concat(拼接)功能,Concat 顺序为输入视频文件 URI 的顺序。

Targetsarray<object>

媒体处理任务列表,支持配置多任务。

UserDatastring

用户自定义信息,在异步消息通知中会为您返回,用于方便您系统内对消息通知进行关联处理。最大长度为 2048 字节。

示例值:{"ID": "testuid","Name": "test-user","Avatar": "http://test.com/testuid"}
Tagsobject

自定义标签,用于对异步任务进行搜索、过滤。

示例值:{"test":"val1"}
CredentialConfigCredentialConfig

链式授权配置对象,一般留空即可。展开详情

NotificationNotification

消息通知对象,支持多种消息中间件,消息格式详情请见异步通知消息格式,请选择其中一种方式接收消息,使用方式如下所示:展开详情

AlignmentIndexinteger<int32>

在进行媒体拼接时,主媒体文件(提供VideoAudio中默认转码参数,包括分辨率、帧率等)在拼接列表中的序号,默认为 0(对齐拼接列表中第一个媒体文件)。

返回参数

字段名称字段详情
RequestIdstring

请求 ID。

示例值:CA995EFD-083D-4F40-BE8A-BDF75FFFE0B6
EventIdstring

事件 ID。

示例值:0ED-1Bz8z71k5TtsUejT4UJ16Es****
TaskIdstring

任务 ID。

示例值:MediaConvert-adb1ee28-c4c9-42a7-9f54-3b8eadcb****

返回示例

变更历史

变更时间变更内容概要操作
2023-05-09
新增请求参数AlignmentIndex
2023-04-03
删除请求参数NotifyTopicName
变更请求参数Targets
2023-03-09
变更请求参数Targets
新增请求参数Notification
2022-08-16
删除请求参数NotifyEndpoint
2022-04-26
新增OpenAPI,创建媒体转码任务

相关示例