Feature Description
Create an audio noise reduction template.
Authorization Description
When using a sub-account, you need to add the ci:CreateMediaTemplate permission to the action in the authorization policy. For all supported API operations in Cloud Infinite, see CI action. Service Activation
To use this feature, bind a bucket in advance and enable Cloud Infinite service.
To use this feature, enable Smart Audio Service in advance via the console or API. Note:
Note: After binding Cloud Infinite (CI), if you manually perform bucket unbinding, you will not be able to continue using this feature.
Use Limits
When using this API, please confirm the relevant restrictions. For details, see Usage Limits. Request
Request sample
POST /template HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml
<body>
Note:
Authorization: A request header that carries authentication information to validate requests. For details, see the Request Signature document. Request header
Request body
The following figure shows the request bodies required for implementing this request operation.
<Request>
<Tag>NoiseReduction</Tag>
<Name>TemplateName</Name>
<NoiseReduction>
<Format>wav</Format>
<Samplerate>16000</Samplerate>
</NoiseReduction>
</Request>
The detailed data is described as follows:
|
Request | None. | Container for saving requests | Container | Yes |
Container type Request
specific data description as follows: |
Tag | Request | NoiseReduction | String | Yes |
Name | Request | Template name, supporting only Chinese, English, digits, _, -, and *, with a length not exceeding 64. | String | Yes |
NoiseReduction | Request | Noise reduction parameters | Container | Yes |
Container type NoiseReduction
specific data description as follows: |
Format | Request.NoiseReduction | Muxing format, supports mp3, m4a, wav | String | wav | No |
Samplerate | Request.NoiseReduction | sampling rate Hz 8000, 12000, 16000, 24000, 32000, 44100, 48000 | String | 16000 | No |
Response
Response Headers
Response Body
The response body is returned as application/xml. An example including the complete node data is shown below:
<Response>
<RequestId>NjJmMWQxYjNfOTBmYTUwNjRfNWYyY18x</RequestId>
<Template>
<Tag>NoiseReduction</Tag>
<Name>TemplateName</Name>
<State>Normal</State>
<Tag>NoiseReduction</Tag>
<CreateTime>2020-08-05T11:35:24+0800</CreateTime>
<UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
<BucketId>test-1234567890</BucketId>
<Category>Custom</Category>
<NoiseReduction>
<Format>wav</Format>
<Samplerate>16000</Samplerate>
</NoiseReduction>
</Template>
</Response>
The data are as follows:
|
Response | None. | Container for saving results | Container |
Container node Response
content: |
Template | Response | Container for saving template details | Container |
RequestId | Response | unique request ID | String |
Container node Template
content: |
TemplateId | Response.Template | template ID | String |
Name | Response.Template | Template Name | String |
BucketId | Response.Template | template's bucket | String |
Category | Response.Template | template property, Custom or Official | String |
Tag | Response.Template | Template type Noise reduction | String |
UpdateTime | Response.Template | Update time | String |
CreateTime | Response.Template | Creation time | String |
NoiseReduction | Response.Template | | Container |
Error Code
This request returns common error responses and error codes. For more information, see Error Codes. Practical Case
Request
POST /template HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
Host: test-1234567890.ci.ap-chongqing.myqcloud.com
Content-Length: 1666
Content-Type: application/xml
<Request>
<Tag>NoiseReduction</Tag>
<Name>TemplateName</Name>
<NoiseReduction>
<SampleRate>16000</SampleRate>
<Format>wav</Format>
</NoiseReduction>
</Request>
Response
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 14 Jul 2022 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****
<Response>
<RequestId>NTk0MjdmODlfMjQ4OGY3XzYzYzhf****</RequestId>
<Template>
<TemplateId>t1460606b9752148c4ab182f55163ba7cd</TemplateId>
<Name>TemplateName</Name>
<State>Normal</State>
<Tag>NoiseReduction</Tag>
<CreateTime>2020-08-05T11:35:24+0800</CreateTime>
<UpdateTime>2020-08-31T16:15:20+0800</UpdateTime>
<BucketId>test-1234567890</BucketId>
<Category>Custom</Category>
<NoiseReduction>
<SampleRate>16000</SampleRate>
<Format>wav</Format>
</NoiseReduction>
</Template>
</Response>