project_id

Yes

String

Project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

X-Auth-Token

No

String

User token.

The token is obtained by calling the IAM API used to obtain a user token. The token is the value of X-Subject-Token in the response header.

Authorization

No

String

Authentication information. This parameter is mandatory when AK/SK-based authentication is used.

X-Project_Id

No

String

Project ID. This parameter is mandatory when AK/SK-based authentication is used. It is same as the project ID in path parameters.

X-Sdk-Date

No

String

Time when the request is sent. This parameter is mandatory when AK/SK-based authentication is used.

dx

No

String

Horizontal offset between the start point of the watermark and the vertex of the output video.

• Integer: horizontal offset between the image start point and the video vertex, in pixelsThe value ranges from 0 to 4,096.

• Decimal: horizontal offset ratio of the image start point relative to the video widthA maximum of four decimal places are supported, for example, 0.9999.

For example, if the output video width is 1,920 pixels, dx is 0.1, and referpos is TopRight, the horizontal offset between the upper right corner of the watermark and the right vertex of the video is 192.

dy

No

String

Vertical offset between the start point of the watermark and the vertex of the output video.

• Integer: vertical offset between the image start point and the video vertex, in pixels.The value ranges from 0 to 4,096.

• Decimal: vertical offset ratio of the image start point relative to the video heightA maximum of four decimal places are supported, for example, 0.9999.

For example, if the output video height is 1,080 pixels, dy is 0.1, and referpos is TopRight, the vertical offset between the upper right corner of the watermark and the right vertex of the video is 108.

referpos

No

String

Watermark position.

Possible values are:

• TopRight: upper right corner

• TopLeft: upper left cornerBottom

• Right: lower right corner

• BottomLeft: lower left corner

timeline_start

No

String

Watermark start time, which is used together with timeline_duration.

Its value is a digit.

Unit: s

timeline_duration

No

String

How long the watermark lasts, which is used together with timeline_start.

Its value is a digit greater than or equal to 0.

Default value: ToEND

ToEND indicates that the watermark lasts until the end of the video.

image_process

No

String

How the image watermark is processed. This parameter is used only when type is set to Image.

Possible values are:

• Original: simple scaling

• Grayed: Turn the color image to gray.

• Transparent: transparent

width

No

String

Watermark width.

The value can either be a positive integer or a decimal between 0.0 and 1.0.

• Integer: pixel value of the watermark width (unit: px)The value ranges from 8 to 4,096.

• Decimal: ratio between the video width and watermark widthA maximum of four decimal places are supported, for example, 0.9999.

height

No

String

Watermark height.

The value can either be a positive integer or a decimal between 0.0 and 1.0.

• Integer: pixel value of the watermark height (unit: px)The value ranges from 8 to 4,096.

• Decimal: ratio between the video height and watermark heightA maximum of four decimal places are supported, for example, 0.9999.

base

No

String

Video which the watermark is overlaid on.

Possible values are:

• input: The watermark is overlaid on the input video. The actual size of the output video is scaled proportionally based on the watermark size.

• output: The watermark is overlaid on the output file.

template_name

No

String

Name of each queried watermark template

type

No

String

Watermark type.

Its value is:

Image: image watermark

template_id

Integer

ID of each queried watermark template

error_code

String

Error code

error_msg

String

Error description

201

Watermark template created successfully.

403

Failed to create a watermark template.