Apply watermark | Resemble

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.

Authentication

AuthorizationBearer

API token from https://app.resemble.ai/account/api

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

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

strengthdoubleOptional0-1Defaults to 0.2

Watermark strength for image/video. Ignored for audio.

custom_messagestringOptional<=64 charactersDefaults to resembleai

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

Response

Watermark job created

successboolean

itemobject

$	curl -X POST https://app.resemble.ai/api/v2/watermark/apply \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"url": "string"
>	}'

1	{
2	"success": true,
3	"item": {
4	"uuid": "string",
5	"media_type": "audio",
6	"operation_type": "apply",
7	"status": "pending",
8	"model_version": "perth_v2",
9	"source_media_url": "string",
10	"created_at": "2024-01-15T09:30:00Z",
11	"updated_at": "2024-01-15T09:30:00Z",
12	"watermarked_media": "string",
13	"metrics": {
14	"strength": 1.1,
15	"custom_message": "string",
16	"message_bits_length": 1
17	}
18	}
19	}

Authentication

Headers

Request

Response