watermark

Apply watermark

Changed on

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

Request

  • Base URL: https://app.resemble.ai/api/v2
  • URL: https://app.resemble.ai/api/v2/watermark/apply
  • Auth: HTTP bearer

Headers

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.

output_format'default' | 'source'

default returns WAV (audio), PNG (image), or MP4 (video). source returns the source's format (for example JPEG, AVIF, M4A, or MOV) when it can be reproduced, otherwise the default.

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

Changes