Watermark
Apply logo watermarks to images
POST
/v1/watermark/apply202Apply a logo watermark to an image. Supports configurable position, opacity, scale, and padding.
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
image_url | string (URI) | Yes | URL of the image to watermark |
logo_url | string (URI) | Yes | URL of the logo/watermark image (PNG with transparency recommended) |
position | string | No | Logo placement on the image. Default: bottom-right |
options.opacity | number (0.1-1) | No | Logo opacity (0.1 = nearly transparent, 1.0 = fully opaque). Default: 0.8 |
options.scale | number (0.05-0.5) | No | Logo width as a proportion of image width (0.05-0.5). Default: 0.2 |
options.padding | integer (0-200) | No | Padding from image edges in pixels. Default: 40 |
webhook_url | string (URI) | No | URL to receive progress and completion webhooks |
callback_metadata | object | No | Opaque data returned in webhook payloads |
Request Example
{
"image_url": "https://example.com/image.jpg",
"logo_url": "https://example.com/image.jpg",
"options": {
"opacity": 0.1,
"scale": 0.05,
"padding": 0
},
"webhook_url": "https://example.com/image.jpg"
}Response
{
"data": {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued"
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-03-12T10:00:00.000Z",
"mode": "live"
}
}