v3

latestOpenAPI 3.1.02026-07-31112356215.0 KB
watermark

Apply watermark

Apply a Perth v2 watermark to an audio, image, or video file. The media type is automatically detected from the file content. Processing is asynchronous unless the Prefer: wait header is supplied.

post/watermark/apply

Headers

Authorizationstring required
Prefer'wait'

When set to "wait", the API processes synchronously and returns the completed result.

Request body

urlstring uri required

Public HTTPS URL to the audio, image, or video source.

strengthnumber double

Watermark strength for image/video. Ignored for audio.

custom_messagestring

Message to embed in image/video. Ignored for audio.

Response

Watermark job created

successboolean required