Add Watermark to Video or Image

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

media_url

string

required

URL of the source media file (image or video) to apply watermark to

watermark_type

enum<string>

required

Type of watermark to apply - either "image" for image watermark or "text" for text watermark

Allowed values:

textimage

text

string

optional

Text content for the watermark (required when watermark_type is "text")

watermark_image_url

string

optional

URL of the watermark image file (required when watermark_type is "image")

fontsize

integer

optional

Font size for text watermark in pixels (optional, applies to text watermarks only)

fontcolor

array[integer]

optional

RGB color array for text watermark font (e.g., [255, 255, 255] for white, applies to text watermarks only)

position

string

optional

Position of the watermark on the media - top_left, top_right, bottom_left, bottom_right, or center (optional, defaults to system setting)

scale_ratio

integer

optional

Scale ratio for the watermark size relative to the original media (e.g., 0.1 for 10% of original size, optional)

to_720p

boolean

optional

Whether to convert the output media to 720p resolution (optional, defaults to false)

Example

{
    "media_url": "https://example.com/adam2eve/stable/users/67c92cef3a40fdce8b119f26/video_result/6882f6eaa16849003b12c5e4/Untitled%20Video.mp4",
    "watermark_type": "text",
    "text":"Generated by AI",
    "fontsize": 48,
    "fontcolor": [
        255,
        255,
        255,
        200
    ],
    "position": "bottom_right",
    "scale_ratio": 1,
    "to_720p": false
}

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://video.a2e.ai/api/v1/watermark/start' \
--header 'Content-Type: application/json' \
--data-raw '{
    "media_url": "https://example.com/adam2eve/stable/users/67c92cef3a40fdce8b119f26/video_result/6882f6eaa16849003b12c5e4/Untitled%20Video.mp4",
    "watermark_type": "text",
    "text":"Generated by AI",
    "fontsize": 48,
    "fontcolor": [
        255,
        255,
        255,
        200
    ],
    "position": "bottom_right",
    "scale_ratio": 1,
    "to_720p": false
}'

Responses

🟢200Success

application/json

Body

code

integer

required

0 is OK

data

object

required

result_url

string

required

The result of the watermark task

Example

{
    "code": 0,
    "data": {
        "_id": "688307d024c132003c37365d",
        "request_id": "watermark_56097a14-05fe-4072-adc9-982566b20de1",
        "media_url": "https://example.com/adam2eve/stable/users/67c92cef3a40fdce8b119f26/video_result/6882f6eaa16849003b12c5e4/Untitled%20Video.mp4",
        "watermark_type": "text",
        "text": "Generated by AI",
        "fontsize": 48,
        "fontcolor": [
            255,
            255,
            255,
            200
        ],
        "position": "bottom_right",
        "scale_ratio": 1,
        "to_720p": false,
        "result_url": "https://1day-jumpy.tos-cn-beijing.volces.com/video_text_watermarked/watermark_56097a14-05fe-4072-adc9-982566b20de1.mp4",
        "current_status": "completed",
        "coins": 1,
        "failed_message": "",
        "failed_code": "",
        "createdAt": "2025-07-25T04:28:00.171Z"
    },
    "trace_id": "89cea870-336d-4568-97a9-dfb0087426fe"
}