找不到 API ? 点击 反馈吧
CreateMediaConvertTask
创建一个异步的媒体转码任务，提供媒体转码、媒体拼接、视频截帧、视频转动图等相关音视频媒体文件处理能力
服务地址：
华东1（杭州）
参数配置
高级配置
输入参数
只看必填
注意事项
ProjectName项目名称
Sources媒体文件列表
Targets媒体处理任务列表
0Targets数组元素的详细信息
URI媒体转码输出文件的OSS地址
Container媒体容器类型
Speed媒体倍速播放设置
Segment媒体切片设置
Format媒体切片方式
Duration切片长度
StartNumber起始序号
Video视频处理参数配置
DisableVideo是否禁用视频流生成
请选择布尔值
Stream需要处理的源文件视频流索引号列表
TranscodeVideo视频转码参数
Codec视频编码格式
PixelFormat像素格式
FrameRateOption帧率选项
FrameRate视频帧率
ResolutionOption分辨率选项
Resolution输出视频的分辨率
AdaptiveResolutionDirection是否开启自适应分辨率方向
请选择布尔值
ScaleType缩放模式
Rotation视频顺时针旋转的度数
BitrateOption视频码率选项
Bitrate视频流码率
GOPSize关键帧间隔帧数
CRF指定恒定质量模式
BufferSize动态码率下解码缓存大小
MaxBitrate动态码率下限定最大码率
BFrames连续B帧的数量
Refs参考帧的数量
FilterVideo视频处理参数
Watermarks视频水印列表
0视频水印信息
Type水印类型
Dx取值为整数或小数时不同含义如下：
Dy取值为整数或小数时的不同含义如下：
StartTime添加水印的开始时间
Duration添加水印持续的时间
ReferPos添加水印的基准位置
Content文字水印的内容
FontName文字水印的字体名称
FontSize文字水印的字体大小
FontColor水印文字的字体颜色
FontApha文字水印的字体透明度
BorderWidth文字水印的描边宽度
BorderColor水印文字的描边颜色
URI水印文件的OSS地址
Width水印图片的宽度
Height水印图片的高度
Delogos对视频上某矩形部分进行模糊处理
0视频模糊处理参数
StartTime添加马赛克的开始时间
Duration添加马赛克的持续时间
Dx取值为整数或小数时的不同含义如下：
Dy默认值为0
Width马赛克的宽度
Height马赛克的高度
ReferPos添加马赛克的基准位置
Audio音频处理参数配置
DisableAudio是否禁用音频处理
请选择布尔值
Stream需要处理的源文件音频流索引号列表
TranscodeAudio音频转码参数
Codec音频编码方式
BitrateOption音频码率选项
Bitrate音频码率
Quality音频质量
SampleRateOption音频采样率
SampleRate音频采样率
Channel声道数
BitsPerSample音频采样位深
FilterAudio音频处理参数
Mixing是否将所有音轨混合为单轨
请选择布尔值
Subtitle字幕处理参数配置
DisableSubtitle是否禁用字幕处理
请选择布尔值
Stream需要处理的源文件字幕流索引号列表
ExtractSubtitle字幕提取配置
URI保存提取字幕的OSS地址前缀
Format字幕提取的输出格式
Image截帧、雪碧图或动图目标图片信息
Sprites雪碧图处理列表
0雪碧图处理详细信息
URI保存雪碧图的OSS地址
Format雪碧图的格式
StartTime视频截帧的开始时间
Interval视频截帧的时间间隔
Number小图数量
ScaleWidth单张图片的宽度
ScaleHeight单张图片的高度
TileWidth每行包含的图片数量
TileHeight每列包含的图片数量
Pad小图之间的间隔
Margin小图和雪碧图边缘的间隔
ScaleType缩放方式
Snapshots截帧处理列表
0截帧处理详细信息
URI保存截帧的OSS地址
Format截帧的格式
StartTime视频截帧的开始时间
Interval视频截帧的时间间隔
Number截帧数量
Width图片宽度
Height图片高度
ScaleType缩放方式
Animations动图处理列表
0动图处理详细信息
URI保存动图的OSS地址
Format输出动图格式
FrameRate动图帧率
StartTime动图抽帧起始时间
Interval抽帧间隔
Number抽帧数量
Width动图宽度
Height动图高度
ScaleType缩放方式
StripMetadata去除媒体文件metadata
请选择布尔值
UserData用户自定义信息
Tags自定义标签
CredentialConfig链式授权配置对象
ServiceRole服务角色
PolicyServiceRole参数的角色所需配...
Chain需要传递授权的链列表
Notification消息通知对象
MNS轻量消息队列（原 MNS）消息通知参数
TopicName轻量消息队列SMQ（原 MNS）主题名称
RocketMQRocketMQ消息通知参数
TopicNameRocketMQ Topic名称
InstanceIdRocketMQ实例Id
ExtendedMessageURI使用OSS文件接受任务消息通知
AlignmentIndex在进行媒体拼接时
文档
调用结果
SDK 示例
CLI示例
相关示例
调用历史
错误码
流控
插件下载了解更多
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 IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
- 请确保在使用该接口前，已充分了解智能媒体管理产品的收费方式和价格。
- 调用该接口前，请确保当前 Region 已经存在可用的项目（Project），详见项目管理。
注意 异步任务不保证时效。
- 使用该接口进行媒体转码时，默认只处理一路视频/音频/字幕流，同时支持配置处理的视频/音频/字幕流数量。
- 使用该接口进行媒体拼接时，最大支持的媒体数量为 11 个，此时配置的转码、截帧等参数将作用于拼接后媒体数据。
- 该接口为异步接口，获取任务开始执行后，任务信息只保存 7 天，超过 7 天则无法再获取。调用 GetTask 或 ListTasks 接口获取返回的
TaskId，查看任务信息。也可以通过设置 Notification 消息通知参数，通过消息通知获取任务信息。
请求参数
| 字段名称 | 字段详情 |
|---|---|
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"} |
CredentialConfigobject | 链式授权配置对象，一般留空即可。展开详情 |
Notificationobject | |
AlignmentIndexinteger<int32> | 在进行媒体拼接时，主媒体文件（提供 |
返回参数
| 字段名称 | 字段详情 |
|---|---|
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，创建媒体转码任务 |