Overview
Add custom watermarks to your images. Protect your work with configurable watermarks supporting various positions, sizes, and opacity levels. This is a synchronous API with instant results.
Parameters
Request body parameters for this API
| Name | Type | Required | Description |
|---|---|---|---|
image_url | string | Required | URL of the image to watermark |
watermark_url | string | Required | URL of the watermark image (PNG recommended) |
watermark_scale | number | Optional | Watermark scale relative to image (0.05-1.0, default: 0.2) |
watermark_opacity | number | Optional | Watermark opacity (0.1-1.0, default: 0.8) |
watermark_position | string | Optional | Position: center, top-left, top-right, bottom-left, bottom-right (default: bottom-right) |
Response
Response fields returned by this API
| Field | Type | Description |
|---|---|---|
id | string | Unique job identifier |
status | string | Always 'completed' for synchronous requests |
output_url | string | URL of the watermarked image |
Examples
Code examples coming soon
Detailed code examples in multiple languages will be added here.
Features
- Custom watermark images
- Configurable positioning
- Adjustable size and opacity
- Instant processing (synchronous)
- Supports PNG watermarks with transparency
Use Cases
- Protecting copyrighted images
- Branding product photos
- Adding logos to marketing materials
- Watermarking preview images
- Batch watermarking workflows
Quick Links