功能描述
创建视频增强模板。
请求
请求示例
POST /template HTTP/1.1Host: <BucketName-APPID>.ci.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>Content-Type: application/xml<body>
请求头
请求体
该请求操作的实现需要有如下请求体:
<Request><Tag>VideoProcess</Tag><Name>TemplateName</Name><ColorEnhance><Enable>true</Enable><Contrast></Contrast><Correction></Correction><Saturation></Saturation></ColorEnhance><MsSharpen><Enable>true</Enable><SharpenLevel></SharpenLevel></MsSharpen></Request>
具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 |
Request | 无 | 保存请求的容器 | Container | 是 |
Container 类型 Request 的具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 | 限制 |
Tag | Request | 模板类型:VideoProcess | String | 是 | 无 |
Name | Request | 模板名称 仅支持中文、英文、数字、_、-和* | String | 是 | 无 |
ColorEnhance | Request | 色彩增强 | Container | 否,ColorEnhance 和 MsSharpen 不能同时为空 | 无 |
MsSharpen | Request | 细节增强 | Container | 否,ColorEnhance 和 MsSharpen 不能同时为空 | 无 |
Container 类型 ColorEnhance 的具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 | 默认值 | 限制 |
Enable | Request.ColorEnhance | 色彩增强是否开启 | String | 否 | false | true、false |
Contrast | Request.ColorEnhance | 对比度 | String | 否 | 无 | 值范围:[0, 100],空字符串(表示自动分析) |
Correction | Request.ColorEnhance | 色彩校正 | String | 否 | 无 | 值范围:[0, 1000],空字符串(表示自动分析) |
Saturation | Request.ColorEnhance | 饱和度 | String | 否 | 无 | 值范围:[0, 300],空字符串(表示自动分析) |
Container 类型 MsSharpen 的具体数据描述如下:
节点名称(关键字) | 父节点 | 描述 | 类型 | 是否必选 | 默认值 | 限制 |
Enable | Request.MsSharpen | 细节增强是否开启 | String | 否 | false | true、false |
SharpenLevel | Request.MsSharpen | 增强等级 | String | 否 | 无 | 值范围:[0, 10],空字符串(表示自动分析) |
响应
响应头
响应体
该响应体返回为 application/xml 数据,包含完整节点数据的内容展示如下:
<Response><Template><Tag>VideoProcess</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><VideoProcess><ColorEnhance><Enable>true</Enable><Contrast></Contrast><Correction></Correction><Saturation></Saturation></ColorEnhance><MsSharpen><Enable>true</Enable><SharpenLevel></SharpenLevel></MsSharpen><VideoProcess><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
TemplateId | Response.Template | 模板ID | String |
Name | Response.Template | 模板名称 | String |
BucketId | Response.Template | 模板所属存储桶 | String |
Category | Response.Template | 模板属性,Custom 或者 Official | String |
Tag | Response.Template | 模板类型,VideoProcess | String |
UpdateTime | Response.Template | 更新时间 | String |
CreateTime | Response.Template | 创建时间 | String |
VideoProcess | Response.Template | 详细的模板参数 | Container |
Container节点 VideoProcess 的内容:
节点名称(关键字) | 父节点 | 描述 |
ColorEnhance | Response.Template.VideoProcess | 同请求体中的 Request.ColorEnhance |
MsSharpen | Response.Template.VideoProcess | 同请求体中的 Request.MsSharpen |
错误码
实际案例
请求
POST /template 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=28e9a4986df11bed0255e97ff90500557e0e****Host: test-1234567890.ci.ap-beijing.myqcloud.comContent-Length: 1666Content-Type: application/xml<Request><Tag>VideoProcess</Tag><Name>TemplateName</Name><ColorEnhance><Enable>true</Enable><Contrast></Contrast><Correction></Correction><Saturation></Saturation></ColorEnhance><MsSharpen><Enable>true</Enable><SharpenLevel></SharpenLevel></MsSharpen></Request>
响应
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: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****<Response><Template><Tag>VideoProcess</Tag><TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId><Name>TemplateName</Name><BucketId>test-1234567890</BucketId><Category>Custom</Category><ColorEnhance><Enable>true</Enable><Contrast></Contrast><Correction></Correction><Saturation></Saturation></ColorEnhance><MsSharpen><Enable>true</Enable><SharpenLevel></SharpenLevel></MsSharpen><CreateTime>2020-08-05T11:35:24+0800</CreateTime><UpdateTime>2020-08-31T16:15:20+0800</UpdateTime></Template></Response>