Image Processing API Documentation

Process Image Endpoint

Process images with watermark, format conversion, and quality optimization in one request. Supports both single image and batch processing.

Single Image Processing

POST /api/process
Content-Type: application/json

{
    "url": "https://example.com/image.jpg",
    "format": "WEBP",
    "quality": 85,
    "watermark": "tattoo-build"
}

Batch Processing

POST /api/process
Content-Type: application/json

[
    {
        "url": "https://example.com/image1.jpg",
        "format": "WEBP",
        "quality": 85,
        "watermark": "tattoo-build"
    },
    {
        "url": "https://example.com/image2.png",
        "format": "PNG",
        "quality": 90,
        "watermark": "lifestyle-brew"
    }
]

Parameters:

• url (required): The URL of the image to process
• format (optional): Output format (default: JPEG). Format is case-insensitive.
• quality (optional): Output quality 1-100 (default: 85)
• watermark (optional): Watermark brand to use (default: "tattoo-build")

Format Options:

• JPEG - Standard format for photographs
• PNG - Lossless compression with transparency support
• WEBP - Modern format with superior compression
• GIF - Supports animation (preserves original animation)
• TIFF - High-quality format for professional use
• BMP - Basic bitmap format
• ICO - Icon format (automatically resizes to valid dimensions)

Available Watermarks:

• lifestyle-brew - Lifestyle Brew brand watermark
• tattoo-build - Tattoo Build brand watermark (default)
• my-life-made - My Life Made brand watermark
• decor-seed - Decor Seed brand watermark
• tattoo-plans - Tattoo Plans brand watermark
• pixelorbyt - Pixel or Byte brand watermark

Rate Limits

• Default: 100 requests per hour
• Process endpoint: 30 requests per minute