Apply watermark | Resemble

Apply a watermark to an audio, image, or video file. The media type is automatically detected from the file content. Use the Prefer: wait header for synchronous processing.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

urlstringRequiredformat: "uri"

HTTPS URL to the media file (audio, image, or video).

strengthdoubleOptional0-1Defaults to 0.2

Watermark strength for image/video. Ignored for audio.

custom_messagestringOptionalDefaults to resembleai

Custom message to embed for image/video. Ignored for audio.

Response

Watermark job created

successboolean or null

itemobject or null

1	import requests
2
3	url = "https://app.resemble.ai/api/v2/watermark/apply"
4
5	payload = { "url": "string" }
6	headers = {
7	"Authorization": "Bearer <token>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

1	{
2	"success": true,
3	"item": {
4	"uuid": "string",
5	"media_type": "audio",
6	"source_media_url": "string",
7	"watermarked_media": "string",
8	"metrics": {},
9	"created_at": "2024-01-15T09:30:00Z",
10	"updated_at": "2024-01-15T09:30:00Z"
11	}
12	}

Authentication

Headers

Request

Response