Add Watermark

Add a customizable text watermark to images with control over position, opacity, font, and more.

Request Parameters

Response

Returns the watermarked image in the same format as the input file.

Example Request

    // example.sh
curl -X POST "https://oyyi.xyz/api/image/watermark"   -H "accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@image.jpg" \
  -F "text=© Copyright 2023" \
  -F "position=bottom-right" \
  -F "opacity=0.5" \
  --output watermarked.jpg
  

Example with Python

    // watermark.py
import requests

url = "https://oyyi.xyz/api/image/watermark"

files = {
    'file': open('image.jpg', 'rb')
}

data = {
    'text': '© Copyright 2023',
    'position': 'bottom-right',
    'opacity': 0.5
}

response = requests.post(url, files=files, data=data)

# Save the watermarked image
with open('watermarked.jpg', 'wb') as f:
    f.write(response.content)
  

Example with JavaScript

    // watermark.js
// Using fetch API
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('text', '© Copyright 2023');
formData.append('position', 'bottom-right');
formData.append('opacity', '0.5');

fetch('https://oyyi.xyz/api/image/watermark', {
  method: 'POST',
  body: formData
})
.then(response => response.blob())
.then(blob => {
  // Create a URL for the blob
  const url = URL.createObjectURL(blob);

  // Create a link to download the image
  const a = document.createElement('a');
  a.href = url;
  a.download = 'watermarked.jpg';
  a.click();

  // Clean up by revoking the URL
  URL.revokeObjectURL(url);
})
.catch(error => console.error('Error:', error));
  

Watermark Positions

How It Works

The watermark endpoint adds text to an image with customizable appearance and positioning:

1. Text Rendering: The specified text is rendered using the selected font, size, and color.
2. Opacity Adjustment: The rendered text is made semi-transparent according to the opacity parameter.
3. Shadow (Optional): If enabled, a subtle shadow is added behind the text to improve visibility against varying backgrounds.
4. Rotation (Optional): The text is rotated by the specified angle.
5. Positioning: The watermark is placed at the specified position with the given padding from the edges.
6. Compositing: The watermark is overlaid onto the original image.

The result is an image with a customized text watermark that can be used for branding, copyright protection, or attribution.

Font Examples

Error Responses

Notes

• For optimal visibility, consider using a light color with shadow enabled on dark images, or a dark color on light images.
• The bottom-right position is commonly used for copyright notices and attribution.
• For diagonal watermarks across the entire image, use the center position with rotation set to 45 degrees and a larger font size.
• The opacity parameter is useful for making the watermark less intrusive while still visible.
• The maximum file size allowed is 10MB.
• This operation preserves the alpha channel (transparency) if present in the original image.
• Special characters and Unicode are supported in the watermark text, including copyright symbols (©), trademark symbols (™), and emojis.

Use Cases

• Adding copyright notices to protect intellectual property
• Branding images with company or personal logos
• Adding attribution or credit information to shared images
• Marking images as drafts or proofs
• Adding date stamps or location information to photographs
• Creating branded social media content
• Marking confidential or internal-use-only documents