Creates a watermark template.
Operation description
After you create a watermark template by calling this operation, you can specify the watermark template and watermark asset when you submit a transcoding job. This allows you to add watermark information to the output video.
QPS limit
You can call this operation up to 100 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limit.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
Name | string | Yes | The name of the watermark template. The value can contain letters and digits and can be up to 128 bytes in size. | example-watermark-**** |
Config | string | Yes | The configuration of the watermark template. The value is a JSON object. For more information, see the "WaterMarks" section of the Parameter details topic. Note
If you do not require a positive correlation between the size of text in the watermark and the resolution, you can enable adaptation for the watermark. To do so, add ['adaptive']=true to the TextWaterMark parameter.
| {"Width":"10","Height":"30","Dx":"10","Dy":"5","ReferPos":"TopRight","Type":"Image","Timeline":{"Start":"0","Duration":"10"}} |
Response parameters
Examples
Sample success responses
JSON
format
{
"WaterMarkTemplate": {
"Type": "Image",
"RatioRefer": {
"Dx": "0.51",
"Width": "0.36",
"Height": "0.33",
"Dy": "0.28"
},
"ReferPos": "TopRight",
"State": "Normal",
"Dx": "10",
"Width": "10",
"Height": "30",
"Timeline": {
"Start": "0",
"Duration": "ToEND"
},
"Name": "example-watermark-****",
"Dy": "5",
"Id": "3780bd69b2b74540bc7b1096f564****"
},
"RequestId": "54BB917F-DD35-4F32-BABA-E60E31B21W63"
}
Error codes
For a list of error codes, visit the Service error codes.
Change history
Change time | Summary of changes | Operation |
---|