DreamAPI
DreamAPI
Docs

Video Watermark Remover

POSThttps://api.newportai.com/api/async/video_watermark_remover

The Video Watermark Remover API automatically removes watermarks from videos using advanced AI algorithms. This API processes videos while maintaining high quality and preserving the original content.

  • Submit a POST request to the Video Watermark Remover API to obtain a taskId.
  • Submit a POST request to the Polling API to retrieve the processing results.
  • Configure a Callback URL to receive results automatically on completion.

Request Headers

Content-Type string Required

Enum: application/json

Authorization string Required

Bearer authentication token. Example: Bearer {{APIKey}}.

Request Body

video string Required

The URL of the video file to process. Note: The video must meet the following constraint: width × height × fps × duration < 1920 × 1080 × 30 × 120. And maximum supported resolution: 2K (2560*1440).

prompt string

Optional prompt for watermark removal guidance. Default: empty string.

seed integer

Random seed for reproducible results. Default: 42.

Response

code integer

Returns 0 for success, or a specific error code.

message string

Returns "success" or a descriptive error message.

data object
taskId string

The unique identifier for the task. Use this ID with the Polling API to retrieve the generated output.

Errors

10192Illegal param

Polling

Use the Polling API to retrieve the processing results.

Callback

Alternatively, you can enable Callback to receive task results automatically upon completion.

0Task Completed
{
    "code": 0,
    "message": "success",
    "data": {
        "task": {
            "taskId": "b08337dc08d7428daa64b3d5e61b8350",
            "status": 3,
            "executionTime": 221829,
            "expire": 1769052600483,
            "taskType": "video_watermark_remover"
        },
        "videos": [
            {
                "videoType": "mp4",
                "videoUrl": "https://dreamface-resource-aigc.oss-us-east-1.aliyuncs.com/apiDocsAdmin/2025-4-1744793368637-watermark_removed.mp4"
            }
        ]
    }
}
Request
cURL
curl -X POST 'https://api.newportai.com/api/async/video_watermark_remover' \
  -H "Authorization: Bearer {{key}}" \
  -H 'Content-Type: application/json' \
  -d '{
    "video": "https://d2t5pyzt5qvy2d.cloudfront.net/api/static_resource/prod/default/mq0MSmKgPGQQsxS9UovqH.mp4",
    "prompt": "remove watermark",
    "seed": 42
}'
0Successful
{
    "code": 0,
    "message": "success",
    "data": {
        "taskId": "b08337dc08d7428daa64b3d5e61b8350"
    }
}