Why does Pinterest flag my images as AI-generated?

Pinterest aggressively scans EXIF metadata and AI markers. If your image contains any sign of AI generation or editing, it can get labeled with a GenAI tag—or be hidden. Our tool removes all tags, signatures, and metadata, disguising your images as authentic camera shots.

Can you guarantee my AI images won't be detected or labeled on Pinterest?

No tool can guarantee permanent bypass, but we scrub every known marker: EXIF, C2PA, XMP, Adobe, and inject realistic camera data. We monitor Pinterest detection tricks weekly and adapt—most competitors only remove basic EXIF data.

How is your tool different from ExifCleaner, Metadata2Go, or Pics.io?

Competitors do basic or server-side removal and can miss critical AI markers. We clean everything 100% client-side, add device simulation and zero uploads—your images never leave your machine.

I lost traffic after using AI images on Pinterest, even after removing EXIF. Why?

Pinterest checks for much more than standard EXIF, like invisible AI fingerprints and unnatural camera data. Our tool eliminates all, adding randomized device information, so your posts stay undetected—basic EXIF cleaners are no longer enough.

What types of images and formats do you support?

All major image types—JPG, PNG, WebP, TIFF, BMP. We also inject camera EXIF (iPhone, Canon, Sony) so your AI images look genuine. Batch processing, ZIP download, and multi-image support included.

How do I remove GPS location from my photos?

Our tool automatically removes all GPS coordinates and location data from your images. Simply upload your photos and we'll strip all location metadata, including GPS coordinates, geotags, and any location-related EXIF data before you download.

Is your tool really 100% client-side? Do my images get uploaded?

Yes, 100% client-side. All processing happens in your browser using JavaScript. Your images never leave your device—we don't upload, store, or have access to any of your files. This ensures complete privacy and security.

Can I process multiple images at once?

Yes! Our tool supports batch processing. Upload as many images as you need, and they'll all be processed simultaneously. You can download them individually or as a single organized ZIP folder for easy management.

Can I use cleaned AI images on Redbubble, Printful, or other POD platforms?

Yes! Our tool is perfect for POD sellers. We remove all AI markers and add realistic camera EXIF, making your images appear as authentic photos. This helps your products get approved and perform better on platforms like Redbubble, Printful, Merch by Amazon, and more.

Image Processing API

Complete guide for processing images via API

Overview

The Image Processing API allows you to process images by removing AI detection markers and adding realistic camera metadata. Images can be uploaded as files or provided as URLs.

Base URL: /api/v1/images

Authentication: Required via API Key (see Authentication section)

Authentication

All endpoints require authentication using an API key with the process_images permission.

Headers

X-API-Key: your-api-key-here

Or alternatively:

X-Authorization: your-api-key-here
Authorization: Bearer your-api-key-here

Endpoints

1. Process Images

Process one or more images by uploading files or providing URLs.

POST /api/v1/images/process

Request Parameters

Parameter	Type	Required	Description
`images[]`	File[]	Yes*	Array of image files (JPEG, PNG, WebP, max 10MB each, max 50 images)
`image_urls[]`	String[]	Yes*	Array of image URLs (max 50 URLs)
`camera_preset`	String	No	Camera preset (default: `iphone_14_pro`)
`processing_options`	Object	No	Processing options (see below)
`custom_metadata`	Object	No	Custom metadata to add to the image

*Either images[] or image_urls[] is required, but not both.

Processing Options

{
  "addGPS": false,
  "varySettings": true,
  "addPhotoshop": false,
  "randomTimestamp": true
}

Request Examples

File Upload (cURL):

curl -X POST https://aicleanify.com/api/v1/images/process \
  -H "X-API-Key: your-api-key" \
  -F "images[]=@photo1.jpg" \
  -F "images[]=@photo2.jpg" \
  -F "camera_preset=canon_eos_r5"

URLs (cURL):

curl -X POST https://aicleanify.com/api/v1/images/process \
  -H "X-API-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "image_urls": [
      "https://example.com/image1.jpg",
      "https://example.com/image2.jpg"
    ],
    "camera_preset": "canon_eos_r5"
  }'

JavaScript/Fetch:

const formData = new FormData();
formData.append('images[]', file1);
formData.append('images[]', file2);
formData.append('camera_preset', 'iphone_14_pro');

fetch('https://aicleanify.com/api/v1/images/process', {
  method: 'POST',
  headers: {
    'X-API-Key': 'your-api-key'
  },
  body: formData
});

Response (Success - 202 Accepted)

{
  "success": true,
  "message": "Image processing started",
  "data": {
    "count": 2,
    "images": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "status": "pending",
        "progress_percentage": 0,
        "original_image_url": "https://aicleanify.com/storage/..."
      }
    ]
  }
}

2. Check Processing Status

Get the current status and progress of an image processing job.

GET /api/v1/images/{uuid}/status

Request Example

curl -X GET https://aicleanify.com/api/v1/images/{uuid}/status \
  -H "X-API-Key: your-api-key"

Response (Success - 200 OK)

{
  "success": true,
  "data": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "status": "processing",
    "progress_percentage": 70,
    "camera_preset": "iphone_14_pro",
    "original_image_url": "...",
    "processed_image_url": null,
    "error_message": null,
    "processed_at": null,
    "created_at": "2025-12-01T20:00:00+00:00"
  }
}

Status Values

pending - Job is queued, waiting to be processed
processing - Image is currently being processed
completed - Processing completed successfully
failed - Processing failed (check <code class="bg-gray-100 px-1 rounded">error_message</code>)

3. Download Processed Image

Download the processed image file.

GET /api/v1/images/{uuid}/download

Request Example

curl -X GET https://aicleanify.com/api/v1/images/{uuid}/download \
  -H "X-API-Key: your-api-key" \
  -o processed_image.jpg

Available Camera Presets

The following camera presets are available for use in the API:

All Camera Presets (72 total)

iphone_12_mini Phone

iPhone 12 Mini - Compact Mobile Photography

Make/Model: Apple iPhone 12 mini

Lens: iPhone 12 mini back dual wide camera 4.2mm f/1.6

One-handed food shots, casual recipe content, pocket-friendly

samsung_galaxy_z_flip_5 Phone

Samsung Galaxy Z Flip 5 - Foldable Creative Angles

Make/Model: Samsung SM-F731B

Lens: Samsung SM-F731B back camera 5.4mm f/1.8

Unique overhead angles, hands-free recipe filming, creative content

motorola_edge_50_pro Phone

Motorola Edge 50 Pro - Budget-Friendly Mobile

Make/Model: Motorola motorola edge 50 pro

Lens: Motorola edge 50 pro back camera 6.3mm f/1.4

Budget content creators, everyday food photography

canon_eos_rp Camera

Canon EOS RP - Affordable Full-Frame Mirrorless

Make/Model: Canon Canon EOS RP

Lens: RF35mm F1.8 MACRO IS STM

Entry full-frame food photography, budget-conscious creators

nikon_z5 Camera

Nikon Z5 - Value Full-Frame Mirrorless

Make/Model: NIKON CORPORATION NIKON Z 5

Lens: NIKKOR Z 24-50mm f/4-6.3

Affordable full-frame, hobbyist food bloggers

sony_a6400 Camera

Sony A6400 - Popular APS-C Vlogger Choice

Make/Model: SONY ILCE-6400

Lens: E 16-50mm F3.5-5.6 PZ OSS

Food vlogging, recipe videos, YouTube content

fujifilm_xs10 Camera

Fujifilm X-S10 - Compact Hybrid Camera

Make/Model: FUJIFILM X-S10

Lens: XC15-45mmF3.5-5.6 OIS PZ

Hybrid shooters, travel food photography, film simulation aesthetics

canon_eos_90d Camera

Canon EOS 90D - APS-C DSLR Workhorse

Make/Model: Canon Canon EOS 90D

Lens: EF-S18-135mm f/3.5-5.6 IS USM

Traditional DSLR users, action food photography, sports events

nikon_d7500 Camera

Nikon D7500 - Enthusiast APS-C DSLR

Make/Model: NIKON CORPORATION NIKON D7500

Lens: AF-S DX NIKKOR 16-80mm f/2.8-4E ED VR

Semi-professional food photography, event coverage

pentax_k3_iii Camera

Pentax K-3 Mark III - Weather-Sealed DSLR

Make/Model: RICOH IMAGING COMPANY, LTD. PENTAX K-3 Mark III

Lens: smc PENTAX-DA 18-135mm F3.5-5.6 ED AL[IF] DC WR

Outdoor food photography, farmers market shots, weather protection

oppo_find_x6_pro Phone

Oppo Find X6 Pro - Hasselblad Mobile Camera

Make/Model: OPPO CPH2491

Lens: Oppo CPH2491 back camera 6.76mm f/1.8

Mobile food photography, social media content

vivo_x90_pro Phone

Vivo X90 Pro - Zeiss Optics Mobile

Make/Model: vivo V2242

Lens: vivo V2242 back camera 6.93mm f/1.75

Premium mobile photography, food content with bokeh

huawei_p60_pro Phone

Huawei P60 Pro - XMAGE Camera System

Make/Model: HUAWEI ALG-AN00

Lens: Huawei ALG-AN00 back camera 6.7mm f/1.4

Low-light food photography, night restaurant shots

sony_a7c Camera

Sony A7C - Compact Full-Frame for Travel

Make/Model: SONY ILCE-7C

Lens: FE 28-60mm F4-5.6

Travel food blogging, street food, compact full-frame

panasonic_g9 Camera

Panasonic LUMIX G9 - Micro Four Thirds Photo Beast

Make/Model: Panasonic DC-G9

Lens: LEICA DG VARIO-ELMARIT 12-60mm F2.8-4.0

High-speed food action shots, burst photography

olympus_omd_em1_iii Camera

Olympus OM-D E-M1 Mark III - Pro Micro Four Thirds

Make/Model: OM DIGITAL SOLUTIONS E-M1MarkIII

Lens: M.ZUIKO DIGITAL ED 12-40mm F2.8 PRO

Professional food photography, weather-sealed shoots

leica_m11 Camera

Leica M11 - Rangefinder Luxury Photography

Make/Model: LEICA CAMERA AG LEICA M11

Lens: Summilux-M 1:1.4/50 ASPH.

Fine art food photography, minimalist aesthetic, luxury content

sigma_fp_l Camera

Sigma fp L - Compact Full-Frame Modular

Make/Model: SIGMA fp L

Lens: SIGMA 45mm F2.8 DG DN Contemporary

Minimalist food photography, modular setups, creative projects

canon_eos_r100 Camera

Canon EOS R100 - Entry-Level Mirrorless

Make/Model: Canon Canon EOS R100

Lens: RF-S18-45mm F4.5-6.3 IS STM

Beginner food bloggers, starter camera for recipes

nikon_zfc Camera

Nikon Z fc - Retro-Styled APS-C Mirrorless

Make/Model: NIKON CORPORATION NIKON Z fc

Lens: NIKKOR Z DX 16-50mm f/3.5-6.3 VR

Vintage-aesthetic food photos, Instagram-worthy content

fujifilm_xh2s Camera

Fujifilm X-H2S - High-Speed Hybrid Camera

Make/Model: FUJIFILM X-H2S

Lens: XF16-55mmF2.8 R LM WR

High-speed recipe videos, action food photography

canon_eos_r3 Camera

Canon EOS R3 - Professional Sports & Action

Make/Model: Canon Canon EOS R3

Lens: RF70-200mm F2.8 L IS USM

Fast-paced restaurant photography, chef action shots

sony_a9_iii Camera

Sony A9 III - Global Shutter Professional

Make/Model: SONY ILCE-9M3

Lens: FE 85mm F1.4 GM II

Professional action food, high-end restaurant photography

nikon_z6_iii Camera

Nikon Z6 III - Versatile Full-Frame Hybrid

Make/Model: NIKON CORPORATION NIKON Z 6III

Lens: NIKKOR Z 24-120mm f/4 S

All-around food content, hybrid photo/video work

panasonic_s1h Camera

Panasonic LUMIX S1H - Cinema-Grade Video Camera

Make/Model: Panasonic DC-S1H

Lens: LUMIX S PRO 24-70mm F2.8

Professional recipe films, cooking shows, documentary

red_komodo_6k Camera

RED KOMODO 6K - Professional Cinema Camera

Make/Model: RED Digital Cinema KOMODO 6K

Lens: Canon CN-E 24mm T1.5 L F

High-end food commercials, cinematic recipe content

arri_alexa_mini_lf Camera

ARRI ALEXA Mini LF - Hollywood Cinema Camera

Make/Model: ARRI ALEXA Mini LF

Lens: ARRI Signature Prime 47mm T1.8

Ultra high-end food commercials, brand campaigns

sony_fx30 Camera

Sony FX30 - Cinema Line APS-C

Make/Model: SONY ILME-FX30

Lens: E PZ 10-20mm F4 G

Professional food videos, recipe series, YouTube creators

canon_c70 Camera

Canon EOS C70 - Compact Cinema Camera

Make/Model: Canon EOS C70

Lens: RF24-105mm F4 L IS USM

Documentary-style food content, cooking shows

zcam_e2_f6 Camera

Z CAM E2-F6 - Professional Cinema Camera

Make/Model: Z CAM E2-F6

Lens: Canon EF 50mm f/1.4 USM

Independent food filmmaking, documentary work

iphone_16_pro_max Phone

iPhone 16 Pro Max - Latest Flagship (Food & Lifestyle)

Make/Model: Apple iPhone 16 Pro Max

Lens: iPhone 16 Pro Max back triple camera 7.02mm f/1.78

Food blogging, recipe pins, Instagram reels, TikTok content

samsung_galaxy_s23_ultra Phone

Samsung Galaxy S23 Ultra - Android Flagship

Make/Model: Samsung SM-S918B

Lens: Samsung S23 Ultra back camera 6.4mm f/1.7

Mobile content creation, food photography, social media

canon_r6_mark_ii Camera

Canon EOS R6 Mark II - Hybrid Creator

Make/Model: Canon Canon EOS R6 Mark II

Lens: RF24-105mm F4-7.1 IS STM

Recipe videos, food photography, Pinterest pins

sony_zve1 Camera

Sony ZV-E1 - Vlog & Content Creation Specialist

Make/Model: SONY ZV-E1

Lens: E PZ 16-50mm F3.5-5.6 OSS

Food vlogs, recipe tutorials, YouTube content, Instagram reels

canon_m50_mark_ii Camera

Canon EOS M50 Mark II - Budget Vlogger Favorite

Make/Model: Canon Canon EOS M50 Mark II

Lens: EF-M15-45mm f/3.5-6.3 IS STM

Beginner food bloggers, recipe videos, affordable content creation

panasonic_lumix_s5 Camera

Panasonic LUMIX S5 - Hybrid Photo/Video

Make/Model: Panasonic DC-S5

Lens: LUMIX S 20-60mm F3.5-5.6

Food videography, recipe demos, professional content

olympus_omd_em10_iv Camera

Olympus OM-D E-M10 Mark IV - Compact & Lightweight

Make/Model: OM DIGITAL SOLUTIONS E-M10 Mark IV

Lens: M.ZUIKO DIGITAL ED 14-42mm F3.5-5.6 EZ

Travel food photography, overhead shots, compact setup

xiaomi_13_ultra Phone

Xiaomi 13 Ultra - Mobile Photography Beast

Make/Model: Xiaomi 2304FPN6DG

Lens: Xiaomi 13 Ultra back camera 6.7mm f/1.9

Mobile food photography, social media, recipe shots

ricoh_gr_iii Camera

Ricoh GR III - Compact Street & Food Photography

Make/Model: RICOH IMAGING COMPANY, LTD. RICOH GR III

Lens: GR LENS 18.3mm F2.8

Casual food photography, street food, pocket camera aesthetic

canon_g7x_mark_iii Camera

Canon PowerShot G7 X Mark III - Vlogger Compact

Make/Model: Canon Canon PowerShot G7 X Mark III

Lens: 8.8-36.8mm f/1.8-2.8

Food vlogging, recipe tutorials, YouTube food content

nikon_z30 Camera

Nikon Z30 - Entry-Level Vlogging Camera

Make/Model: NIKON CORPORATION NIKON Z 30

Lens: NIKKOR Z DX 16-50mm f/3.5-6.3 VR

Beginner vloggers, recipe videos, food content creation

fujifilm_xt30_ii Camera

Fujifilm X-T30 II - Retro Style Content Creation

Make/Model: FUJIFILM X-T30 II

Lens: XF18-55mmF2.8-4 R LM OIS

Aesthetic food photos, vintage recipe content, film-look pins

oneplus_11_pro Phone

OnePlus 11 Pro - Hasselblad Mobile Camera

Make/Model: OnePlus CPH2449

Lens: OnePlus CPH2449 back camera 6.73mm f/1.8

Mobile food content, recipe photography, social media

sony_rx100_vii Camera

Sony RX100 VII - Premium Compact Pocket Camera

Make/Model: SONY DSC-RX100M7

Lens: 24-200mm F2.8-4.5

Professional food photography, detail shots, travel food

google_pixel_7a Phone

Google Pixel 7a - Affordable Computational Photography

Make/Model: Google Pixel 7a

Lens: Pixel 7a back camera 5.81mm f/1.9

Budget food blogging, recipe pins, mobile content

panasonic_gh6 Camera

Panasonic LUMIX GH6 - Professional Video Powerhouse

Make/Model: Panasonic DC-GH6

Lens: LUMIX G VARIO 12-60mm F3.5-5.6

Recipe videos, cooking tutorials, professional food content

canon_r50 Camera

Canon EOS R50 - Entry Mirrorless for Beginners

Make/Model: Canon Canon EOS R50

Lens: RF-S18-45mm F4.5-6.3 IS STM

Beginner food bloggers, learning photography, affordable setup

sony_a6700 Camera

Sony A6700 - APS-C Content Creation

Make/Model: SONY ILCE-6700

Lens: E 16-55mm F2.8 G

Hybrid photo/video, recipe content, professional food pins

nikon_z8 Camera

Nikon Z8 - Professional Hybrid Camera

Make/Model: NIKON CORPORATION NIKON Z 8

Lens: NIKKOR Z 24-120mm f/4 S

Professional food photography, high-end recipe content

dji_osmo_pocket_3 Camera

DJI Osmo Pocket 3 - Portable Gimbal Camera

Make/Model: DJI Osmo Pocket 3

Lens: Osmo Pocket 3 20mm f/2.0

Recipe process videos, cooking tutorials, smooth food footage

insta360_x3 Camera

Insta360 X3 - 360° Action Camera

Make/Model: Arashi Vision Insta360 X3

Lens: Dual fisheye 5.7mm f/1.9

360° food experiences, immersive restaurant content, creative pins

blackmagic_pocket_6k Camera

Blackmagic Pocket Cinema 6K - Cinema Quality Food Videos

Make/Model: Blackmagic Design Pocket Cinema Camera 6K Pro

Lens: Canon EF 24-70mm f/2.8L II USM

Cinematic recipe videos, professional food films, high-end content

hasselblad_x2d Camera

Hasselblad X2D 100C - Ultimate Medium Format

Make/Model: Hasselblad X2D 100C

Lens: XCD 3.5/30mm

Ultra high-end food photography, magazine quality, luxury brands

phase_one_xf_iq4 Camera

Phase One XF IQ4 - Professional Studio Medium Format

Make/Model: Phase One A/S XF IQ4 150MP

Lens: Schneider Kreuznach 80mm LS f/2.8

Studio food photography, cookbook shoots, commercial work

iphone_se_3rd_gen Phone

iPhone SE (3rd Gen) - Budget Apple Device

Make/Model: Apple iPhone SE (3rd generation)

Lens: iPhone SE (3rd generation) back camera 3.99mm f/1.8

Budget food blogging, beginner recipe pins, casual content

canon_eos_r5 Camera

Canon EOS R5 - Professional DSLR (Landscapes, Portraits)

Make/Model: Canon Canon EOS R5

Lens: RF24-105mm F4 L IS USM

Landscapes, portraits, professional photography

nikon_z9 Camera

Nikon Z9 - Professional Mirrorless (Sports, Wildlife)

Make/Model: NIKON CORPORATION NIKON Z 9

Lens: NIKKOR Z 24-70mm f/2.8 S

Sports, wildlife, action photography

sony_a7iv Camera

Sony A7 IV - Full-Frame Mirrorless (All-around Pro)

Make/Model: SONY ILCE-7M4

Lens: FE 24-70mm F2.8 GM

All-around professional photography, video

iphone_15_pro Phone

iPhone 15 Pro - Perfect for Food & Social Media

Make/Model: Apple iPhone 15 Pro

Lens: iPhone 15 Pro back triple camera 6.86mm f/1.78

Food photography, social media content, recipe pins

iphone_14_pro Phone

iPhone 14 Pro - Mobile Photography (Very Common)

Make/Model: Apple iPhone 14 Pro

Lens: iPhone 14 Pro back triple camera 6.86mm f/1.78

Everyday photos, mobile content creation

iphone_13_pro Phone

iPhone 13 Pro - Mobile Photography

Make/Model: Apple iPhone 13 Pro

Lens: iPhone 13 Pro back triple camera 5.7mm f/1.5

Mobile photography, social media

canon_5d_iv Camera

Canon EOS 5D Mark IV - Wedding & Events

Make/Model: Canon Canon EOS 5D Mark IV

Lens: EF24-70mm f/2.8L II USM

Wedding photography, events, portraits

fujifilm_xt5 Camera

Fujifilm X-T5 - Street & Travel Photography

Make/Model: FUJIFILM X-T5

Lens: XF18-55mmF2.8-4 R LM OIS

Street photography, travel, documentary

google_pixel_8_pro Phone

Google Pixel 8 Pro - Computational Photography

Make/Model: Google Pixel 8 Pro

Lens: Pixel 8 Pro back camera 6.9mm f/1.68

Computational photography, mobile content

samsung_galaxy_s24_ultra Phone

Samsung Galaxy S24 Ultra - Mobile Photography

Make/Model: Samsung SM-S928B

Lens: Samsung S24 Ultra back camera 6.4mm f/1.7

Mobile photography, social media

photoshop_edited Camera

Photoshop Edited - Professional Post-Processing

Make/Model: Canon Canon EOS R6

Lens: RF24-105mm F4-7.1 IS STM

Professional edited content, polished images

sony_a7rv Camera

Sony A7R V - High Resolution (Studio & Landscape)

Make/Model: SONY ILCE-7RM5

Lens: FE 24-70mm F2.8 GM II

High-detail studio work, landscapes, commercial

leica_q3 Camera

Leica Q3 - Premium Street Photography

Make/Model: LEICA CAMERA AG LEICA Q3

Lens: Summilux 1:1.7/28 ASPH.

Street photography, documentary, luxury lifestyle

dji_mavic_3_pro Camera

DJI Mavic 3 Pro - Aerial & Drone Photography

Make/Model: DJI FC4362

Lens: Mavic 3 Pro Hasselblad Camera 24mm f/2.8

Aerial shots, landscapes, real estate

gopro_hero12 Camera

GoPro HERO12 Black - Action & Adventure

Make/Model: GoPro HERO12 Black

Lens: GoPro HERO12 Wide Lens

Action sports, underwater, travel vlogs

nikon_d850 Camera

Nikon D850 - Classic DSLR Workhorse

Make/Model: NIKON CORPORATION NIKON D850

Lens: AF-S NIKKOR 24-70mm f/2.8E ED VR

Studio, landscape, wedding photography

fujifilm_gfx100s Camera

Fujifilm GFX 100S - Medium Format (Ultra High Quality)

Make/Model: FUJIFILM GFX100S

Lens: GF32-64mmF4 R LM WR

High-end fashion, commercial, fine art

Processing Workflow

Submit Images - Send images via POST /api/v1/images/process and receive UUIDs for each image
Track Progress - Poll GET /api/v1/images/{uuid}/status to check progress. Monitor progress_percentage (0-100) and status field
Download Results - Once status is completed, download via GET /api/v1/images/{uuid}/download or use processed_image_url from status response

Rate Limits

Maximum 50 images per request (for both file uploads and URLs)
Maximum 10MB (10,240 KB) per image file
Supported formats: JPEG, JPG, PNG, WebP
Processing happens asynchronously via queue

Error Handling

All errors follow a consistent format:

{
  "success": false,
  "message": "Error description",
  "error": "Detailed error message (optional)",
  "errors": {
    "field": ["Validation error messages"]
  }
}

Note: Authentication errors (401) may use error and message keys instead of success. Validation errors (422) include an errors object with field-specific messages.

Common Error Codes

400 - Bad Request (invalid input or processing not completed)
401 - Unauthorized (missing or invalid API key)
403 - Forbidden (API key inactive, expired, or missing permission)
404 - Not Found (UUID not found or processed image not found)
422 - Validation Error (invalid data format)
500 - Internal Server Error

Complete Example Workflow

Step 1: Process Images

curl -X POST https://aicleanify.com/api/v1/images/process \
  -H "X-API-Key: your-api-key" \
  -F "images[]=@photo.jpg" \
  -F "camera_preset=iphone_14_pro"

Response: Returns UUID for tracking

Step 2: Check Status (Polling)

curl -X GET https://aicleanify.com/api/v1/images/{uuid}/status \
  -H "X-API-Key: your-api-key"

Poll every 2-5 seconds until status is "completed"

Step 3: Download Processed Image

curl -X GET https://aicleanify.com/api/v1/images/{uuid}/download \
  -H "X-API-Key: your-api-key" \
  -o processed_photo.jpg

Best Practices

Polling Interval: Check status every 2-5 seconds while processing
Error Handling: Always check status and error_message fields
Batch Processing: Process multiple images in a single request for efficiency
URL Validation: Ensure image URLs are publicly accessible
File Size: Keep images under 10MB for optimal performance