| fit | No | How to fit into width x height: scale-down never enlarges; cover fills and crops; pad adds borders | scale-down |
| url | No | Or a public https URL of an image or zip | |
| flip | No | Flip: h = horizontal, v = vertical, hv = both | none |
| width | No | Width in pixels | |
| format | No | Output format (keep turns HEIC into JPEG and GIF into PNG) | keep |
| height | No | Height in pixels | |
| rotate | No | Rotate clockwise (degrees) | |
| file_id | No | Image or zip file (up to 25 MB on this page) | |
| quality | No | Quality 1-100 for JPEG, WebP and AVIF; lower is smaller. Ignored with target_bytes | |
| crop_top | No | Crop: top edge (px, or % of the height with crop_unit percent) | |
| filename | No | Name for the output when the source has none | |
| max_side | No | Instead of width and height: the longest side in pixels, per image, so portrait and landscape images both get it on their long edge. Never enlarges unless fit is contain | |
| crop_left | No | Crop: left edge (px, or % of the width with crop_unit percent) | |
| crop_unit | No | Unit of the four crop fields: px (whole pixels) or percent (0-100 of each image, so a zip of different sizes gets the same part of every image) | px |
| keep_date | No | With strip_metadata: keep the EXIF date taken (DateTimeOriginal and DateTimeDigitized, with their time zone and fraction of a second) so photos still sort by date. A date and time taken found only in XMP or PNG text is written as the EXIF DateTimeOriginal; IPTC dates are not kept | |
| background | No | JPEG only: colour under transparent areas, #rrggbb | #ffffff |
| crop_width | No | Crop: width (px, or % of the width with crop_unit percent) | |
| crop_aspect | No | Instead of the four crop fields: the largest centered crop of this width:height ratio, per image | |
| crop_height | No | Crop: height (px, or % of the height with crop_unit percent) | |
| data_base64 | No | Base64 bytes of an image or zip, up to 3 MB decoded; use create_upload (up to 100 MB) or url above that | |
| resize_unit | No | Unit of width and height: px, or percent (1-1000) of each image's own size, so a zip of different sizes is scaled alike. Over 100 enlarges only with fit contain | px |
| watermark_x | No | With watermark_position custom: the centre of the text, % of each image's width from the left (0-100) | |
| watermark_y | No | With watermark_position custom: the centre of the text, % of each image's height from the top (0-100) | |
| target_bytes | No | Instead of quality: the most bytes each output may have (10,000-50,000,000; 1 MB = 1,000,000), for upload forms with a size limit. Uses the highest quality from 45 to 92 that fits; if even 45 is too big, the image is scaled down too. Each item then reports the quality used, and over_target when it could not get under | |
| keep_copyright | No | With strip_metadata: keep the EXIF Copyright tag. XMP and IPTC rights are not kept | |
| strip_metadata | No | Remove EXIF, GPS location and camera data | |
| watermark_size | No | Watermark font size: px (8-400, whole numbers) or, with watermark_size_unit percent, % of each image's width (0.5-20, giving 12-1000 px). Default 4% of the width | |
| watermark_text | No | Watermark text | |
| watermark_color | No | Watermark color, #rrggbb | #ffffff |
| watermark_image | No | Logo for the watermark, with or instead of watermark_text: a file_id from create_upload, a public https url, or data:image/png;base64,... (up to 1 MB inline; an inline image and logo share the 3 MB inline limit). PNG with transparency is best; WebP and JPEG work. Up to 2 MB and 2048 px on the longest side; rasterise SVG to PNG first. With text, the logo sits left of the text and both are placed as one | |
| watermark_opacity | No | Watermark opacity, 0.05 to 1 | |
| watermark_position | No | Watermark position; custom places the centre of the text at watermark_x, watermark_y | bottom-right |
| watermark_size_unit | No | Unit of watermark_size: px, or percent of each image's width (so a zip of different sizes gets the same relative size) | px |
| watermark_image_size | No | Logo width, % of each image's width (2-50). Default 15 | |