详情页标题前

腾讯云对象存储提交任务

• 腾讯云
详情页1

功能描述

提交一个视频合成任务。

授权说明

授权策略中 action 设置为 ci:CreateMediaJobs 。查看所有 action。

服务开通

使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

请求

请求示例

POST /jobs HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml
<body>

说明：Authorization: Auth String（详情请参见 请求签名 文档）。通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求体

该请求操作的实现需要有如下请求体。

    VideoSynthesis            t160606b9752148c4absdfaf2f55163b1f        t146d70eb241c44c63b6efc1cc93ccfc5d                    false                            https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4                640                                        https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4                700                640                960                                        ap-chongqing            test-123456789            output/out.${ext}                This is my data.        0        http://callback.demo.com    JSON

具体的数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Request 无 保存请求的容器 Container 是

Container 类型 Request 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Tag Request 创建任务的 Tag：VideoSynthesis String 是
Input Request 待操作的文件信息 Container 是
Operation Request 操作规则 Container 是
CallBackFormat Request 任务回调格式，JSON 或 XML，默认 XML，优先级高于队列的回调格式 String 否
CallBackType Request 任务回调类型，Url 或 TDMQ，默认 Url，优先级高于队列的回调类型 String 否
CallBack Request 任务回调地址，优先级高于队列的回调地址。设置为 no 时，表示队列的回调地址不产生回调 String 否
CallBackMqConfig Request 任务回调TDMQ配置，当 CallBackType 为 TDMQ 时必填。详情见 CallBackMqConfig Container 否

Container 类型 Input 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Object Request.Input 文件路径 String 是

Container 类型 Operation 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
VideoSynthesis Request.Operation 视频合成模板参数 Container 是
TranscodeTemplateId Request.Operation 转码模板 ID String 否
Transcode Request.Operation 转码模板参数 Container 否
WatermarkTemplateId Request.Operation 水印模板 ID，可以传多个水印模板 ID，最多传3个 String 数组 否
Watermark Request.Operation 水印模板参数，同创建水印模板接口中的 Request.Watermark，最多传3个 Container 数组 否
Output Request.Operation 结果输出配置 Container 是
UserData Request.Operation 透传用户信息，可打印的 ASCII 码，长度不超过1024 String 否
JobLevel Request.Operation 任务优先级，级别限制：0 、1 、2 。级别越大任务优先级越高，默认为0 String 否

说明：转码参数必须设置，可以通过 TranscodeTemplateId 或 Transcode 设置， TranscodeTemplateId 优先级更高。水印参数可选，可以通过 WatermarkTemplateId 或 Watermark 设置，WatermarkTemplateId 优先级更高。Container 类型 VideoSynthesis 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
KeepAudioTrack Request.Operation.VideoSynthesis 是否保留源视频音轨，取值 true/false，默认值 false String 否
SpliceInfo Request.Operation.VideoSynthesis 待合成的视频 Container 数组 是

Container 类型 SpliceInfo 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Url Request.Operation.VideoSynthesis.SpliceInfo 同 bucket 的视频文件地址 String 是
X Request.Operation.VideoSynthesis.SpliceInfo 该视频在画面中的横坐标，默认值 0 String 否
Y Request.Operation.VideoSynthesis.SpliceInfo 该视频在画面中的纵坐标，默认值 0 String 否
Width Request.Operation.VideoSynthesis.SpliceInfo 该视频在画面中的宽，默认原视频宽 String 否
Height Request.Operation.VideoSynthesis.SpliceInfo 该视频在画面中的高,默认原视频高 String 否
Name Request.Operation.VideoSynthesis.SpliceInfo 该视频流的自定义名称, 长度不超过64个字符，仅支持中文、英文、数字、_、-和* String 否

Container 类型 Transcode 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
TimeInterval Request.Operation.Transcode 同创建转码模板接口中的 Request.TimeInterval Container 否
Container Request.Operation.Transcode 同创建转码模板接口中的 Request.Container Container 否
Video Request.Operation.Transcode 同创建转码模板接口中的 Request.Video Container 否
Audio Request.Operation.Transcode 同创建转码模板接口中的 Request.Audio Container 否
TransConfig Request.Operation.Transcode 同创建转码模板接口中的 Request.TransConfig Container 否
AudioMix Request.Operation.Transcode 混音参数，详情见 AudioMix Container 否
AudioMixArray Request.Operation.Transcode 混音参数数组，最多同时传2个 Container 数组 否

说明：不传 Video，相当于删除视频信息。不传 Audio，相当于删除音频信息。Video 和 Audio 不可以同时不传。AudioMix 和 AudioMixArray 在 Audio.Remove 为 false 时生效。AudioMixArray 是一个数组，每一个子项内容同 AudioMix 。AudioMix 优先级更高，设置 AudioMix 时，AudioMixArray 无效。Container 类型 Output 的具体数据描述如下：

节点名称（关键字） 父节点 描述 类型 是否必选
Region Request.Operation.Output 存储桶的地域 String 是
Bucket Request.Operation.Output 存储结果的存储桶 String 是
Object Request.Operation.Output 输出结果的文件名 String 是

Request.Operation.Output.Object 支持的通配符如下：

通配符 含义
${ext} 封装格式
${jobid} 任务 Id

响应

响应头

此接口仅返回公共响应头部，详情请参见 公共响应头部 文档。

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：

            Success                j8d121820f5e411ec926ef19d53ba9c6f        Submitted        2022-06-27T14:44:10+0800        -        -        p2242ab62c7c94486915508540933a2c6        VideoSynthesis                    t160606b9752148c4absdfaf2f55163b1f            t146d70eb241c44c63b6efc1cc93ccfc5d                            false                                    https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4                    640                                                    https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4                    700                    640                    960                                                        ap-chongqing                test-123456789                output/out.${ext}                        This is my data.            0

具体的数据内容如下：

节点名称（关键字） 父节点 描述 类型
Response 无 保存结果的容器 Container

Container 节点 Response 的内容：

节点名称（关键字） 父节点 描述 类型
JobsDetail Response 任务的详细信息 Container 数组

Container 节点 JobsDetail 的内容：

节点名称（关键字） 父节点 描述 类型
Code Response.JobsDetail 错误码，只有 State 为 Failed 时有意义 String
Message Response.JobsDetail 错误描述，只有 State 为 Failed 时有意义 String
JobId Response.JobsDetail 新创建任务的 ID String
Tag Response.JobsDetail 新创建任务的 Tag：VideoSynthesis String
State Response.JobsDetail 任务状态Submitted：已提交，待执行Running：执行中Success：执行成功Failed：执行失败Pause：任务暂停，当暂停队列时，待执行的任务会变为暂停状态Cancel：任务被取消执行 String
Progress Response.JobsDetail 任务进度百分比，只有在State为 Submitted、Running、Success、Pause 时有意义，范围为[0, 100] String
CreationTime Response.JobsDetail 任务的创建时间 String
StartTime Response.JobsDetail 任务的开始时间 String
EndTime Response.JobsDetail 任务的结束时间 String
QueueId Response.JobsDetail 任务所属的 队列 ID String
Input Response.JobsDetail 该任务的输入资源地址 Container
Operation Response.JobsDetail 该任务的规则 Container

Container 节点 Input 的内容：

节点名称（关键字） 父节点 描述 类型
Region Response.JobsDetail.Input 存储桶的地域 String
Bucket Response.JobsDetail.Input 存储结果的存储桶 String
Object Response.JobsDetail.Input 输出结果的文件名 String

Container 节点 Operation 的内容：

节点名称（关键字） 父节点 描述 类型
VideoSynthesis Response.JobsDetail.Operation 同请求中的 Request.Operation.VideoSynthesis Container
TranscodeTemplateId Response.JobsDetail.Operation 同请求中的 Request.Operation.TranscodeTemplateId String
Transcode Response.JobsDetail.Operation 同请求中的 Request.Operation.Transcode Container
Watermark Response.JobsDetail.Operation 同请求中的 Request.Operation.Watermark Container 数组
WatermarkTemplateId Response.JobsDetail.Operation 同请求中的 Request.Operation.WatermarkTemplateId String 数组
Output Response.JobsDetail.Operation 同请求中的 Request.Operation.Output Container
MediaInfo Response.JobsDetail.Operation 输出文件的媒体信息，任务未完成时不返回，详见 MediaInfo Container
MediaResult Response.JobsDetail.Operation 输出文件的基本信息，任务未完成时不返回，详见 MediaResult Container
DigitalWatermark Response.JobsDetail.Operation 同请求中的 Request.Operation.DigitalWatermark Container
UserData Response.JobsDetail.Operation 透传用户信息 String
JobLevel Response.JobsDetail.Operation 任务优先级 String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

请求

POST /jobs HTTP/1.1Authorization: q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR****&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0ea057Host: test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 166Content-Type: application/xml
    VideoSynthesis            t160606b9752148c4absdfaf2f55163b1f        t146d70eb241c44c63b6efc1cc93ccfc5d                    false                            https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4                640                                        https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4                700                640                960                                        ap-chongqing            test-123456789            output/out.${ext}                This is my data.        0        http://callback.demo.com    JSON

响应

HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 230Connection: keep-aliveDate: Mon, 28 Jun 2022 15:23:12 GMTServer: tencent-cix-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
            Success                je8f65004eb8511eaaed4f377124a303c        Submitted        0        2019-07-07T12:12:12+0800        -        -        p2242ab62c7c94486915508540933a2c6        VideoSynthesis                    t160606b9752148c4absdfaf2f55163b1f            t146d70eb241c44c63b6efc1cc93ccfc5d                            false                                    https://test-123456789.cos.ap-chongqing.myqcloud.com/input/car.mp4                    640                                                    https://test-123456789.cos.ap-chongqing.myqcloud.com/input/game.mp4                    700                    640                    960                                                        ap-chongqing                test-123456789                output/out.${ext}                        This is my data.            0



对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠

转转请注明出处：https://www.yunxiaoer.com/145192.html

赞 (0)
0
上一篇 2023年12月9日
下一篇 2023年12月9日
详情页2

相关推荐

  • 腾讯云云函数(SCF)SCF + TRTC 输入在线媒体流-云淘科技 腾讯云

    腾讯云云函数(SCF)SCF + TRTC 输入在线媒体流-云淘科技

    使用场景 案例 AI 互动课堂 通过录播真人教学视频结合 AI 技术进行线上直播互动教学。上课前，根据教师的课程设置，将知识点讲解、互动提问、问题反馈和解答等信息录制成视频片段，上传到视频库。课堂中，通过云函数将已有的录播视频推送到 TRTC 房间进行直播。学生通过语音、触屏实现互动式学习。服务端通过 AI 技术，智能识别学生的实时语音和作答，并根据学生的表…

    2023年12月9日

  • 腾讯云容器镜像服务从自建 Harbor 同步镜像到 TCR 企业版同尘

    操作场景 当用户将在 IDC 内自建的容器集群迁移至云上容器服务时，也可选择将自建的容器镜像托管服务一同迁移至云上进行托管。将自建的镜像仓库服务迁移至腾讯云容器镜像服务 TCR 后，一方面减少了用户自行搭建及维护的运维管理成本，并提供云上专业稳定的托管服务及技术支持。另一方面实现了与云上容器服务的联动使用，用户可享受容器上云的一致性使用体验，可使用容器集群内…

    腾讯云 2023年12月9日

  • 腾讯云云托付物理服务器修改服务器配置云淘

    操作场景 生产 CHC 云服务器实例后，建议参考本文配置服务器，以利于更好地使用腾讯云资源。说明本文以 CentOS 操作系统的 CHC 云服务器为例进行配置。 操作步骤 配置 bond 配置 bond 可以使服务器避免单点故障，提高服务器的可靠性。请您结合实际情形进行操作：已配置 bond未配置 bond如您的服务器已配置 bond，建议修改 bond 的…

    腾讯云 2023年12月9日
  • 腾讯TencentOS Server联系我们 腾讯云

    腾讯TencentOS Server联系我们

    售前咨询 当您需要购买咨询时，您可以直接通过 售前咨询 进行提问，会有专属客户经理在线为您解答，为您提供专业的上云方案。同时，您也可以直接致电销售人员，咨询热线：4009100100转1（工作日9:00 – 18:00）。 售后支持 当您遇到问题需要处理时，您可以直接通过 售后支持 进行提问，腾讯云工程师7 × 24小时在线为您提供服务。同时，您…

    2023年12月9日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机

  • 腾讯云容器服务TKE 边缘集群计费通知同尘科技

    为了提升客户服务质量，提供给您更稳定，更可量化的服务保障，腾讯云计划于2022年10月20日11:00（北京时间）对所有 TKE 边缘集群正式开始计费，消费产生的费用将计入账单，进行扣费。针对7种不同规格，腾讯云均提供高质量的服务以及 SLA 承诺。每种规格的集群可管理不同的边缘节点规模，同时管理的 Kubernetes 对象数目也各不相同，您可根据业务需求…

    腾讯云 2023年12月9日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。