功能描述
创建音视频拼接模板。
授权说明
授权策略中 action 设置为 ci:CreateMediaTemplate 。查看所有 action。
服务开通
使用该功能需提前开通数据万象，并绑定存储桶。详情请参见 绑定存储桶。
使用限制
使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
请求
请求实例
POST /template 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（详情请参见 请求签名 文档）。通过子账号使用时，需要授予相关的权限，详情请参见 授权粒度详情 文档。
请求头
公共头部
该请求操作的实现使用公共请求头，了解公共请求头详情请参见 公共请求头部 文档。
非公共头部
该请求操作无特殊的请求头部信息。
请求体
该请求操作的实现需要有如下请求体。
Concat TemplateName Start http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4 End http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4 mp3 H.264 1000 1280 30 mp4 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3 Once true true 3 false 0 true 1.7 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3 Once true true 3 false 0 true 1.7
具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Request | 无 | 保存请求的容器 | Container | 是 |
Container 类型 Request 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 必选 |
| Tag | Request | 模板类型：Concat | String | 是 |
| Name | Request | 模板名称仅支持中文、英文、数字、_、-和*，长度不超过 64 | String | 是 |
| ConcatTemplate | Request | 拼接模板 | Container | 是 |
Container 类型 ConcatTemplate 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| ConcatFragment | Request.ConcatTemplate | 拼接节点 | Container 数组 | 无 | 是 |
| Audio | Request.ConcatTemplate | 音频参数 | Container | 媒体原始值 | 否 |
| Video | Request.ConcatTemplate | 视频参数 | Container | 媒体原始值 | 否 |
| Container | Request.ConcatTemplate | 封装格式 | Container | 无 | 是 |
| AudioMix | Request.ConcatTemplate | 混音参数，详情见 AudioMix | Container | 无 | 否 |
| AudioMixArray | Request.ConcatTemplate | 混音参数，最多同时传2个 | Container 数组 | 无 | 否 |
| DirectConcat | Request.ConcatTemplate | 只拼接不转码，取值 true/ false | String | false | 否 |
| SceneChangeInfo | Request.ConcatTemplate | 转场参数 | Container | 无 | 否 |
说明AudioMix 和 AudioMixArray 在 Audio.Remove 为 false 时生效。AudioMixArray 是一个数组，每一个子项内容同 AudioMix 。AudioMix 优先级更高，设置 AudioMix 时，AudioMixArray 无效。Container 数组 类型 ConcatFragment 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Url | Request.ConcatTemplate.ConcatFragment | 拼接对象地址 | String | 无 | 是 |
| Mode | Request.ConcatTemplate.ConcatFragment | 节点类型Start：开头End：结尾 | String | 无 | 是 |
| StartTime | Request.ConcatTemplate.ConcatFragment | 开始时间，单位为秒, 支持 float 格式，执行精度精确到毫秒，当Request.ConcatTemplate.DirectConcat 为 true 时不生效 | String | 无 | 否 |
| Duration | Request.ConcatTemplate.ConcatFragment | 结束时间，单位为秒, 支持 float 格式，执行精度精确到毫秒，当 Request.ConcatTemplate.DirectConcat 为 true 时不生效 | String | 无 | 否 |
Container 类型 Audio 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Codec | Request.ConcatTemplate.Audio | 编解码格式，取值 aac、mp3 | String | 无 | 是 |
| Samplerate | Request.ConcatTemplate.Audio | 采样率单位：Hz可选 11025、22050、32000、44100、48000、96000不同的封装，mp3 支持不同的采样率，如下表所示 | String | 文件原采样率 | 否 |
| Bitrate | Request.ConcatTemplate.Audio | 音频码率单位：Kbps值范围：[8，1000] | String | 文件原音频码率 | 否 |
| Channels | Request.ConcatTemplate.Audio | 声道数当 Codec 设置为 aac，支持1、2、4、5、6、8当 Codec 设置为 mp3，支持1、2 | String | 文件原声道数 | 否 |
Y 表示支持这种采样率，N 表示不支持。
| 封装格式/音频采样率 | 11025 | 22050 | 32000 | 44100 | 48000 | 96000 |
| mp3 | Y | Y | Y | Y | Y | N |
Container 类型 Container 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 是否必选 |
| Format | Request.ConcatTemplate.Container | 封装格式：mp4，flv，hls，ts, mp3, aac | String | 是 |
Container 类型 Video 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Codec | Request.ConcatTemplate.Video | 编解码格式，取值H.264，H.265 | String | H.264 | 是 |
| Width | Request.ConcatTemplate.Video | 宽值范围：[128，4096]单位：px若只设置 Width 时，按照视频原始比例计算 Height必须为偶数 | String | 视频原始宽度 | 否 |
| Height | Request.ConcatTemplate.Video | 高值范围：[128，4096]单位：px若只设置 Height 时，按照视频原始比例计算 Width必须为偶数 | String | 视频原始高度 | 否 |
| Fps | Request.ConcatTemplate.Video | 帧率值范围：(0，60]单位：fps | String | 视频原始帧率 | 否 |
| Bitrate | Request.ConcatTemplate.Video | 视频输出文件的码率值范围：[10，50000]单位：Kbps | String | 视频原始码率 | 否 |
| Crf | Request.ConcatTemplate.Video | 码率-质量控制因子值范围：(0, 51]如果设置了 Crf，则 Bitrate 的设置失效当 Bitrate 为空时，默认为25 | String | 视频原始码率 | 否 |
| Remove | Request.ConcatTemplate.Video | 是否删除视频流，取值 true、false | String | false | 否 |
| Rotate | Request.ConcatTemplate.Video | 旋转角度值范围：[0, 360)单位：度 | String | 无 | 否 |
Container 类型 SceneChangeInfo 的具体数据描述如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 | 默认值 | 是否必选 |
| Mode | Request.ConcatTemplate.SceneChangeInfo | 转场模式Default：不添加转场特效FADE：淡入淡出GRADIENT：渐变 | String | 无 | 是 |
| Time | Request.ConcatTemplate.SceneChangeInfo | 转场时长单位：秒(s)取值范围：(0, 5]，支持小数 | String | 3 | 否 |
响应
响应头
公共响应头
该响应包含公共响应头，了解公共响应头详情请参见 公共响应头部 文档。
特有响应头
该响应无特殊的响应头。
响应体
该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
NjQ0NGNlNDZfMThhYTk0MGFfY********* t1460606b9752148c4ab182f55163ba7cd Concat TemplateName test-1234567890 Custom Start http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4 End http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4 mp3 H.264 1000 1280 30 mp4 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3 Once true true 3 false 0 true 1.7 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3 Once true true 3 false 0 true 1.7 2020-08-05T11:35:24+0800 2020-08-31T16:15:20+0800
具体的数据内容如下：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| Template | Response | 保存模板详情的容器 | Container |
| RequestId | Response | 请求的唯一 ID | String |
Container 节点 Template 的内容：
| 节点名称（关键字） | 父节点 | 描述 | 类型 |
| TemplateId | Response.Template | 模板 ID | String |
| Name | Response.Template | 模板名称 | String |
| BucketId | Response.Template | 模板所属存储桶 | String |
| Category | Response.Template | 模板属性，Custom 或者 Official | String |
| Tag | Response.Template | 模板类型，Concat | String |
| UpdateTime | Response.Template | 更新时间 | String |
| CreateTime | Response.Template | 创建时间 | String |
| ConcatTemplate | Response.Template | 同请求体中的 Request.ConcatTemplate | Container |
错误码
该请求无特有错误信息，常见的错误信息请参见 错误码 文档。
实际案例
请求
POST /template HTTP/1.1Authorization:q-sign-algorithm=sha1&q-ak=AKIDZfbOAo7cllgPvF9cXFrJD0a1ICvR98****-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=28e9a4986df11bed0255e97ff90500557e0e****Host:test-1234567890.ci.ap-chongqing.myqcloud.comContent-Length: 1666Content-Type: application/xml
Concat TemplateName Start http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4 End http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4 mp3 H.264 1000 1280 30 mp4 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3 Once true true 3 false 0 true 1.7 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3 Once true true 3 false 0 true 1.7
响应
HTTP/1.1 200 OKContent-Type: application/xmlContent-Length: 100Connection: keep-aliveDate: Thu, 14 Jul 2022 12:37:29 GMTServer: tencent-cix-ci-request-id: NjMxMDJhYTNfMThhYTk0MGFfYmU1OV8zZjc=
NjQ0NGNlNDZfMThhYTk0MGFfY********* t1460606b9752148c4ab182f55163ba7cd Concat TemplateName test-1234567890 Custom Start http://bucket-1250000000.cos.ap-beijing.myqcloud.com/start.mp4 End http://bucket-1250000000.cos.ap-beijing.myqcloud.com/end.mp4 mp3 H.264 1000 1280 30 mp4 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix1.mp3 Once true true 3 false 0 true 1.7 https://test-xxx.cos.ap-chongqing.myqcloud.com/mix2.mp3 Once true true 3 false 0 true 1.7 2020-08-05T11:35:24+0800 2020-08-31T16:15:20+0800
对象存储官网1折活动，限时活动，即将结束，速速收藏
同尘科技为腾讯云授权服务中心。
购买腾讯云产品享受折上折，更有现金返利。同意关联立享优惠
转转请注明出处：https://www.yunxiaoer.com/145154.html
