tencent cloud

APIs

文档APIsCloud Object StorageJob and WorkflowAppendixStructure

结构体

下载
聚焦模式
字号
最后更新时间： 2025-11-19 20:10:34

MediaWorkflow_Topology_Nodes_Start_Input

节点名称（关键字）
描述
类型
是否必选
限制
ObjectPrefix
Object 前缀
String
是
无
QueueId
队列 ID
String
是
无
PicProcessQueueId
图片处理队列 ID
String
当存在图片处理节点时必选
无
SpeechRecognitionQueueId
语音识别队列 ID
String
当存在语音识别节点时必选
无
AIProcessQueueId
AI 处理队列 ID
String
当存在 AI 识别节点时必选
无
NotifyConfig
回调信息，如果不设置，则使用队列的回调信息
Container
否
无
ExtFilter
文件后缀过滤器
Container
否
无
Container 类型 NotifyConfig 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
默认值
限制
Url
回调地址
String
是
无
不能为内网地址
Type
回调类型
String
是
无
Url：url 回调
TDMQ：tdmq 消息回调
Event
回调信息
String
是
无
TaskFinish：任务完成
WorkflowFinish：工作流完成
支持多种事件，以逗号分隔
ResultFormat
回调格式
String
否
XML
XML：xml 格式
JSON：json 格式
MqRegion
TDMQ 所属园区
String
否
无
当回调类型为 TDMQ 时必填，支持园区详见 TDMQ请求地域说明文档
MqMode
TDMQ 使用模式
String
否
无
当回调类型为 TDMQ 时必填。
Topic：主题订阅
Queue：队列服务
MqName
TDMQ 主题名称
String
否
无
当回调类型为 TDMQ 时必填。
Container 类型 ExtFilter 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
默认值
限制
State
开关
String
否
Off
On/Off
Video
打开视频后缀限制
String
否
false
false/true
Audio
打开音频后缀限制
String
否
false
false/true
Image
打开图片后缀限制
String
否
false
false/true
ContentType
打开 ContentType 限制
String
否
false
false/true
Custom
打开自定义后缀限制
String
否
false
false/true
CustomExts
自定义后缀
String
否
无
多种文件后缀以/分隔，后缀个数不超过10个
当 Custom 为 true 时，该参数必填
AllFile
所有文件
String
否
false
false/true

MediaWorkflow_Topology_Nodes_***_Operation_Output

节点名称（关键字）
描述
类型
是否必选
限制
Region
存储桶的地域
String
是
无
Bucket
存储桶的名称
String
是
无
Object
结果文件名称
String
是
当工作流节点类型为 Snapshot 或 SmartCover，且结果文件不止一个时，必须包含 ${Number} $
当工作流节点类型为 Segment，设置了 Duration，且 Format 不为 HLS 或 m3u8 时，必须包含 ${Number}
SpriteObject
雪碧图的名称
String
否
当工作流节点类型为 Snapshot，且打开了雪碧图时，该字段必填
AuObject
人声结果文件名称
String
否
当工作流节点类型为 VoiceSeparate，且有人声输出时，该字段必填

MediaWorkflow_Topology_Nodes_Snapshot_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
截图模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_Animation_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
视频转动图模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_SmartCover_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
智能封面模板 ID
String
否
无
SmartCover
智能封面参数
Container，详情请参见 SmartCover
否
无
Output
输出地址
Container，详情请参见 Output
是
无
说明
TemplateId 和 SmartCover 都可以不设置，默认以原视频大小生成3张封面。如果同时设置 TemplateId 和 SmartCover，TemplateId 优先生效。

MediaWorkflow_Topology_Nodes_Transcode_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
音视频转码模板 ID
String
否
无
WatermarkTemplateId
水印模板 ID
String 数组
否
可以使用多个水印模板，不超过3个
RemoveWatermark
去除水印参数
Container，详情请参见 RemoveWatermark
否
无
DigitalWatermark
数字水印参数
Container，详情请参见 DigitalWatermark
否
无
Output
输出地址
Container，详情请参见 Output
是
无
Input
输入配置
Container
否
无
Container 类型 MediaWorkflow_Topology_Nodes_Transcode_***_Operation.Input 的具体数据描述如下：
节点名称（关键字）
描述
类型
必选
限制
SpeedTranscodingQueueId
倍速转码队列
String
否
无

MediaWorkflow_Topology_Nodes_Concat_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
拼接模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_VoiceSeparate_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
人声分离模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_VideoMontage_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
精彩集锦模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_SDRtoHDR_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
SDRtoHDR
SDRtoHDR 配置
Container
是
无
TranscodeTemplateId
音视频转码模板 ID
String
是
无
WatermarkTemplateId
水印模板 ID
String 数组
否
可以使用多个水印模板，不超过3个
Output
输出地址
Container，详情请参见 Output
是
无
Container 类型 SDRtoHDR 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
HdrMode
HDR 标准
String
是
HLG
HDR10

MediaWorkflow_Topology_Nodes_VideoProcess_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
视频增强模板 ID
String
是
无
TranscodeTemplateId
音视频转码模板 ID
String
是
无
WatermarkTemplateId
水印模板 ID
String 数组
否
可以使用多个水印模板，不超过3个
DigitalWatermark
数字水印参数
Container，详情请参见 DigitalWatermark
否
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_SCF_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
SCF
SCF 函数信息
Container
是
无
Container 类型 SCF 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
Region
函数地域
String
是
无
FunctionName
函数名称
String
是
无
Namespace
命名空间
String
否
无
Alias
函数别名
String
否
无

MediaWorkflow_Topology_Nodes_SuperResolution_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
超级分辨率模板 ID
String
是
无
TranscodeTemplateId
音视频转码模板 ID
String
是
无
WatermarkTemplateId
水印模板 ID
String 数组
否
可以使用多个水印模板，不超过3个
DigitalWatermark
数字水印参数
Container，详情请参见 DigitalWatermark
否
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_Segment_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
Segment
音视频转封装参数
Container
是
无
Output
输出地址
Container，详情请参见 Output
是
无
Container 类型 Segment 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
Format
封装格式
String
是
aac、mp3、flac、mp4、ts、mkv、avi、hls、m3u8
Duration
转封装时长,单位:秒
String
否
不小于5的整数
HlsEncrypt
hls 加密配置
Container
否
只有当封装格式为 hls 时生效，详情请参见 HlsEncrypt

MediaWorkflow_Topology_Nodes_PicProcess_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
图片处理模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_Tts_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
语音合成模板 ID
String
是
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_SpeechRecognition_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
Output
输出地址
Container，详情请参见 Output
是
无
StreamPackConfig
打包配置
Container
是
无

MediaWorkflow_Topology_Nodes_StreamPackConfig_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
StreamPackConfig
打包配置
Container
否
无
Container 类型 StreamPackConfig 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
PackType
打包类型。默认值：HLS
String
否
HLS/DASH
IgnoreFailedStream
忽略转码失败的子流，继续打包。默认值：true
String
否
true/false

MediaWorkflow_Topology_Nodes_VideoStream_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
TemplateId
音视频转码模板 ID
String
否
无
WatermarkTemplateId
水印模板 ID
String 数组
否
可以使用多个水印模板，不超过3个
RemoveWatermark
去除水印参数
Container，详情请参见 RemoveWatermark
否
无
Output
输出地址
Container，详情请参见 Output
是
无

MediaWorkflow_Topology_Nodes_StreamPack_***_Operation

节点名称（关键字）
描述
类型
是否必选
限制
StreamPackInfo
打包规则
Container
否
无
Container 类型 StreamPackInfo 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
VideoStreamConfig
视频子流配置
Container
否
无
Container 类型 VideoStreamConfig 的具体数据描述如下：
节点名称（关键字）
描述
类型
是否必选
限制
VideoStreamName
视频子流名称
String
是
必须和存在的视频节点对应
BandWidth
视频子流带宽限制，单位b/s，范围[0, 2000000000]，0表示不限制
String
否
大于等于0，默认值是0

AudioMix

节点名称（关键字）
描述
类型
必选
默认值
限制
AudioSource
需要被混音的音轨媒体地址
String
是
无
需与Input媒体文件存储于同一bucket
MixMode
混音模式
String
否
Repeat
Repeat:背景音循环
Once:背景音一次播放
Replace
是否用混音音轨媒体替换Input媒体文件的原音频
String
否
false
true/false
EffectConfig
混音淡入淡出配置
Container
否
false
无
Container 类型 EffectConfig 的具体数据描述如下：
节点名称（关键字）
描述
类型
必选
默认值
限制
EnableStartFadein
开启淡入
String
否
false
true/false
StartFadeinTime
淡入时长
String
否
无
大于0, 支持浮点数
EnableEndFadeout
开启淡出
String
否
false
true/false
EndFadeoutTime
淡出时长
String
否
无
大于0, 支持浮点数
EnableBgmFade
开启bgm转换淡入
String
否
false
true/false
BgmFadeTime
bgm转换淡入时长
String
否
无
大于0, 支持浮点数

CallBackMqConfig

节点名称（关键字）
描述
类型
是否必选
MqRegion
消息队列所属园区，目前支持园区 sh（上海）、bj（北京）、gz（广州）、cd（成都）、hk（中国香港）
String
是
MqMode
消息队列使用模式，默认 Queue ：
主题订阅：Topic
队列服务: Queue
String
是
MqName
TDMQ 主题名称
String
是

DigitalWatermark

节点名称（关键字）
描述
类型
是否必选
限制
Message
嵌入数字水印的水印信息
String
是
长度不超过64个字符，仅支持中文、英文、数字、_、-和*
Type
数字水印类型
String
是
当前仅可设置为 Text
Version
数字水印版本
String
是
当前仅可设置为 V1
IgnoreError
当添加水印失败是否忽略错误继续执行任务
String
是
限制为 true/false
State
添加水印是否成功，执行中为Running，成功为 Success，失败为 Failed
String
否
该字段不能主动设置，当任务提交成功时，会返回该字段

DashEncrypt

节点名称（关键字）
描述
类型
是否必选
默认值
限制
IsEncrypt
是否开启 DASH 加密
String
否
false
true/false
UriKey
DASH 加密的 key
String
否
无
当 IsEncrypt 为 true 时，该参数才有意义

HlsEncrypt

节点名称（关键字）
描述
类型
是否必选
默认值
限制
IsEncrypt
是否开启 HLS 加密
String
否
false
true/false
UriKey
HLS 加密的 key
String
否
无
当 IsEncrypt 为 true 时，该参数才有意义

RemoveWatermark

节点名称（关键字）
描述
类型
是否必选
限制
Dx
距离左上角原点 x 偏移
String
是
值范围：[0, 4096]
单位：px
Dy
距离左上角原点 y 偏移
String
是
值范围：[0, 4096]
单位：px
Width
水印的宽度
String
是
值范围：(0, 4096]
单位：px
Height
水印的高度
String
是
值范围：(0, 4096]
单位：px

SmartCover

节点名称（关键字）
描述
类型
是否必选
默认值
限制
Format
图片格式
String
否
jpg
jpg、png 、webp
Width
宽
String
否
视频原始宽度
值范围：[128，4096]
单位：px
若只设置 Width 时，按照视频原始比例计算 Height
Height
高
String
否
视频原始高度
值范围：[128，4096]
单位：px
若只设置 Height 时，按照视频原始比例计算 Width
Count
截图数量
String
否
3
[1,10]
DeleteDuplicates
封面去重
String
否
false
true/false

上一篇: Pulling Jobs in Batches下一篇: Single Image Moderation

帮助和支持

本页内容是否解决了您的问题？

填写满意度调查问卷，共创更好文档体验。

文档反馈

搜索
    请输入关键词搜索文档