Skip to content

Image API for developers

Resize, convert, compress, watermark and remove backgrounds with one HTTP call.

  • Fast libvips processing
  • Async jobs and webhooks for AI
  • Signed URLs, private storage, 1-hour retention
  • OpenAPI 3.1 specification

Quick start

curl -X POST https://phototools.site/v1/images/resize \
  -H "Authorization: Bearer pt_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg",
    "width": 1200,
    "height": 800,
    "fit": "cover",
    "format": "webp",
    "quality": 82
  }' \
  -o photo.webp

Endpoints

POST/v1/images/resizeResize with exact / fit / contain / cover
POST/v1/images/convertConvert to JPG, PNG, WebP or AVIF
POST/v1/images/compressCompress by quality or to a target size
POST/v1/images/watermarkText or logo watermark
POST/v1/images/productEcommerce: square canvas, white background, WebP
POST/v1/images/metadataRead EXIF, GPS, ICC
POST/v1/images/strip-metadataRemove EXIF losslessly
POST/v1/images/remove-backgroundAI background removal (async)
POST/v1/images/upscaleAI upscale 2× / 4× (async)
POST/v1/images/enhanceAI enhancement (async)
POST/v1/images/blur-backgroundAI portrait blur (async)
POST/v1/uploadsPresigned upload for large files
POST/v1/batchesBatch pipelines with ZIP output
GET/v1/jobs/{id}Job status and result URL
GET/v1/usageQuota and usage

API pricing

Every plan includes test keys. Paid plans include monthly basic transformations and AI credits, with pay-as-you-go beyond the limits.

Pricing