Overlay a visible watermark on your source video with this filter.



Watermarking is not available for the image output.

For more information on how to position a watermark, please see this article.

<?xml version="1.0"?>
    <userid>[UserID]</userid> <!-- required-->
    <userkey>[UserKey]</userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
        <!-- Format fields -->
            <logo_source>[LogoURL]</logo_source> <!-- required-->
            <!-- logo_transparent is alias for logo_threshold -->
    "query": {
        "userid": "[UserID]",
        "userkey": "[UserKey]",
        "action": "[Action]",
        "format": {
            "logo": {
                "logo_source": "[LogoURL]",
                "logo_x": "[LogoLeft]",
                "logo_y": "[LogoTop]",
                "logo_mode": "[LogoMode]",
                "logo_threshold": "[LogoTreshold]",
                "logo_transparent": "[LogoTransparent]"
ParameterDescriptionAllowed ValuesDefault Value
logo_sourceSpecify the URL of the logo image. The image format can be GIF, JPG or PNG.http://[user[:password]@]hostname[:port]/[path]/[filename]


logo_xSpecify the left offset of logo image.Positive integer10
logo_ySpecify the top offset of logo image.Positive integer10
logo_threshold or logo_transparentSpecify the threshold color mask.6-digit hexadecimal 000000—FFFFFF
000000 — sets color black to transparent mask
808080 — sets color gray to transparent mask
logo_modeSpecify the video and watermarking picture mixing mode.0: If the mask color matches the threshold, the logo will be transparent and only the video will be shown.

1: If the mask color is lighter or darker than the threshold value, the logo (watermark) will appear.


For logo_source parameter

<logo_source /> is a required parameter.


For logo_mode parameter

If your logo source is PNG with alpha-channel, set <logo_mode /> equal to 1 to keep transparency.