{
  "openapi": "3.0.3",
  "info": {
    "title": "Image Processing API",
    "version": "1.5.1",
    "description": "Convert, resize with fit modes, crop, flip, rotate, compress and watermark images in PNG, JPEG, WebP, AVIF, GIF and TIFF. Seven image jobs over multipart upload, all reading and writing PNG, JPEG, WebP, AVIF, GIF and TIFF: convert (also BMP and ICO) with quality, background, grayscale, blur, sharpen and metadata control; resize by width, height or both with fit modes (fill, contain, cover, inside, outside) and withoutEnlargement; crop by pixels or fractions; flip; rotate in 90-degree steps; compress with a quality setting, an optional target format and metadata stripping; and add a text or picture watermark with position, opacity, size, rotation and tiling. An operation keeps the input format unless you ask for another. Limits: 15 MB per file (10 MB on trial keys); HEIC/HEIF from phones is not supported; rotation is in steps of 90 degrees; watermark text is one line in Roboto (Latin, Greek and Cyrillic letters); animated GIF and WebP stay animated in convert, resize and compress and use the first frame elsewhere; no URL input and no background removal. Files are processed in memory and nothing is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "Image Processing",
      "description": "Convert, resize with fit modes, crop, flip, rotate, compress and watermark images in PNG, JPEG, WebP, AVIF, GIF and TIFF."
    }
  ],
  "paths": {
    "/v1/image/resize": {
      "post": {
        "summary": "Resize an image by width, height or both, with fit modes, and return the image",
        "operationId": "imageResize",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. Send width, height or both: with one of them the aspect ratio is kept; with both, fit decides how the picture meets the box. fit: fill (the default, stretches to exactly width x height as this endpoint always did), contain (fits inside the box and pads the rest with backgroundColor), cover (fills the box and crops the overflow around the centre), inside (fits within the box keeping the ratio, no padding), outside (at least as large as the box, keeping the ratio). withoutEnlargement=true never makes the picture bigger than the original. Animated GIF and WebP stay animated. Limits: width and height 1 to 16384; the crop of cover is centred (no focal-point choice); output metadata is removed unless stripMetadata=false. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "width": {
                    "type": "number",
                    "description": "Target width in pixels, 1 to 16384. Send width, height or both",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "height": {
                    "type": "number",
                    "description": "Target height in pixels, 1 to 16384",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "fit": {
                    "type": "string",
                    "description": "fill (default, exact size, stretches), contain, cover, inside or outside",
                    "enum": [
                      "fill",
                      "contain",
                      "cover",
                      "inside",
                      "outside"
                    ],
                    "default": "fill"
                  },
                  "withoutEnlargement": {
                    "type": "boolean",
                    "description": "Never make the picture larger than the original. Default false"
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  },
                  "animated": {
                    "type": "boolean",
                    "description": "Keep every frame of an animated GIF or WebP. Default true"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "width": 800,
                "fit": "cover",
                "height": 600
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 1,676 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "320"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "240"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/crop": {
      "post": {
        "summary": "Crop an image by pixels or fractions",
        "operationId": "imageCrop",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. By default x, y, w and h are fractions of the image (0 to 1); add unit=px to give pixel values instead. width and height are accepted as aliases for w and h, and x and y default to 0. A box that runs past the image edge is clamped to the image. The box refers to the upright picture (a phone photo is turned upright from its EXIF flag first). An animated GIF or WebP is cropped on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "unit": {
                    "type": "string",
                    "description": "fraction (default; values 0 to 1) or px (pixels of the original image)",
                    "enum": [
                      "fraction",
                      "px"
                    ],
                    "default": "fraction"
                  },
                  "x": {
                    "type": "number",
                    "description": "Left edge: a fraction 0 to 1, or pixels with unit=px. Default 0"
                  },
                  "y": {
                    "type": "number",
                    "description": "Top edge: a fraction 0 to 1, or pixels with unit=px. Default 0"
                  },
                  "w": {
                    "type": "number",
                    "description": "Width: a fraction above 0 up to 1, or pixels (at least 1) with unit=px. Alias: width"
                  },
                  "h": {
                    "type": "number",
                    "description": "Height: a fraction above 0 up to 1, or pixels (at least 1) with unit=px. Alias: height"
                  },
                  "width": {
                    "type": "number",
                    "description": "Alias for w"
                  },
                  "height": {
                    "type": "number",
                    "description": "Alias for h"
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "w",
                  "h"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "unit": "px",
                "x": 100,
                "y": 50,
                "w": 400,
                "h": 300
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 843 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "200"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "150"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/flip": {
      "post": {
        "summary": "Flip an image horizontally or vertically and return the image",
        "operationId": "imageFlip",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. horizontal mirrors left to right, vertical mirrors top to bottom. An animated GIF or WebP is flipped on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "direction": {
                    "type": "string",
                    "description": "horizontal or vertical",
                    "enum": [
                      "horizontal",
                      "vertical"
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "direction"
                ]
              },
              "example": {
                "file": "sample.png",
                "direction": "horizontal"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 5,747 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/rotate": {
      "post": {
        "summary": "Rotate an image by 90, 180 or 270 degrees and return the image",
        "operationId": "imageRotate",
        "description": "Reads JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG and BMP (not HEIC/HEIF from phones) and writes the same format unless format is given: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. The X-Image-Width, X-Image-Height and X-Image-Frames headers describe the result. Rotates clockwise by 90, 180 or 270 degrees; other angles are not supported. An animated GIF or WebP is rotated on its first frame only. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "degrees": {
                    "type": "number",
                    "description": "Clockwise rotation: 90, 180 or 270",
                    "enum": [
                      90,
                      180,
                      270
                    ]
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file",
                  "degrees"
                ]
              },
              "example": {
                "file": "sample.png",
                "degrees": 90
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 5,835 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "480"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "640"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/compress": {
      "post": {
        "summary": "Make an image file smaller (quality, target format, metadata stripping) and return it",
        "operationId": "imageCompress",
        "description": "Makes an image file smaller and returns it. Same format as the input unless format is given (png, jpeg, webp, avif, gif or tiff; converting, for example PNG to WebP, is often the biggest saving). quality is 1 to 100 (or 0 to 1) for JPEG, WebP and AVIF and defaults to 80 (AVIF 55); JPEG is written progressive. PNG stays lossless at the highest compression unless quality is below 100, which makes a smaller 256-colour palette PNG (lossy). Metadata (EXIF, GPS, colour profile) is removed unless stripMetadata=false. maxWidth and maxHeight shrink the picture first (never enlarge). Animated GIF and WebP stay animated. If the result cannot be made smaller in the same format, the original bytes are returned unchanged and X-Compress-Note says so. The X-Original-Bytes, X-Output-Bytes and X-Reduction-Percent headers report the saving. Limits: the saving depends on the picture (an already optimised JPEG may not shrink); lossy quality settings change pixels; there is no target-file-size mode. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  },
                  "maxWidth": {
                    "type": "number",
                    "description": "Shrink to at most this width first, 1 to 16384 (never enlarges)",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "maxHeight": {
                    "type": "number",
                    "description": "Shrink to at most this height first, 1 to 16384",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "lossless": {
                    "type": "boolean",
                    "description": "WebP and AVIF lossless mode"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "quality": 75,
                "format": "webp"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/webp, 626 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              },
              "X-Original-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file you sent",
                "example": "5747"
              },
              "X-Output-Bytes": {
                "schema": {
                  "type": "string"
                },
                "description": "Size of the file returned",
                "example": "626"
              },
              "X-Reduction-Percent": {
                "schema": {
                  "type": "string"
                },
                "description": "How much smaller, in percent (0 when it could not be made smaller)",
                "example": "89.1"
              },
              "X-Compress-Note": {
                "schema": {
                  "type": "string"
                },
                "description": "Present when the original was returned unchanged or the result is not smaller"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/watermark": {
      "post": {
        "summary": "Add a text or picture watermark to an image and return it",
        "operationId": "imageWatermark",
        "description": "Stamps a watermark on an image and returns it. Send text (up to 200 characters, drawn in Roboto Regular: Latin, Greek and Cyrillic letters; other scripts such as Chinese or Arabic are not drawn) or a watermark picture in the file field watermark (PNG with transparency works best), not both. position: center, top-left, top, top-right, left, right, bottom-left, bottom, bottom-right (default) or tile (repeats across the picture, rotated -30 degrees by default). opacity 0 to 1 (default 0.5), margin in pixels from the edge, rotation in degrees. For text: fontSize in pixels (default about one twelfth of the shorter side), color (a name or hex, default white; a soft shadow keeps it readable). For a picture: scale is its width as a share of the image width (default 0.2). A watermark larger than the picture is scaled down to fit. An animated GIF or WebP is watermarked on its first frame only. Limits: watermark text is one line; there is no per-letter styling, font choice or invisible watermark. Errors: 400 for a missing file or a bad option (the message names it), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image (JPEG, PNG, WebP, AVIF, GIF, TIFF, SVG or BMP). Up to 15 MB."
                  },
                  "text": {
                    "type": "string",
                    "description": "The words to stamp, up to 200 characters. Send this or a watermark picture"
                  },
                  "watermark": {
                    "type": "string",
                    "format": "binary",
                    "description": "The watermark picture (PNG, JPEG, WebP, GIF, TIFF or SVG). Up to 15 MB. Send this or text"
                  },
                  "position": {
                    "type": "string",
                    "description": "center, top-left, top, top-right, left, right, bottom-left, bottom, bottom-right (default) or tile",
                    "enum": [
                      "center",
                      "top-left",
                      "top",
                      "top-right",
                      "left",
                      "right",
                      "bottom-left",
                      "bottom",
                      "bottom-right",
                      "tile"
                    ],
                    "default": "bottom-right"
                  },
                  "opacity": {
                    "type": "number",
                    "description": "0 (invisible) to 1 (solid). Default 0.5",
                    "minimum": 0,
                    "maximum": 1,
                    "default": 0.5
                  },
                  "fontSize": {
                    "type": "number",
                    "description": "Text size in pixels, 6 to 1000",
                    "minimum": 6,
                    "maximum": 1000
                  },
                  "color": {
                    "type": "string",
                    "description": "Text colour: a name such as white or red, or hex such as #ffffff. Default white"
                  },
                  "margin": {
                    "type": "number",
                    "description": "Distance from the edge in pixels, 0 to 2000. Default 2% of the shorter side",
                    "minimum": 0,
                    "maximum": 2000
                  },
                  "rotation": {
                    "type": "number",
                    "description": "Rotation in degrees, -180 to 180. Default 0 (tile: -30)",
                    "minimum": -180,
                    "maximum": 180
                  },
                  "scale": {
                    "type": "number",
                    "description": "Watermark picture width as a share of the image width, above 0 up to 1. Default 0.2",
                    "minimum": 0.01,
                    "maximum": 1,
                    "default": 0.2
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico (image/... types also work). Default: the same format as the input",
                    "enum": [
                      "png",
                      "jpeg",
                      "jpg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (and palette PNG): 0 to 1 (for example 0.8) or 1 to 100 (for example 80)"
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for contain padding, for example #ffffff or white. JPEG always flattens onto it (white by default)"
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, GPS and colour-profile data. Default true; false keeps it"
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "photo.jpg",
                "text": "SAMPLE",
                "position": "bottom-right",
                "opacity": 0.5
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/png, 13,682 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Width of the result in pixels",
                "example": "640"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Height of the result in pixels",
                "example": "480"
              },
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of frames (1 unless an animated GIF or WebP was kept)",
                "example": "1"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/image/convert": {
      "post": {
        "summary": "Convert an image to PNG, JPEG, WebP, AVIF, GIF, TIFF, BMP or ICO and return the image",
        "operationId": "imageConvert",
        "description": "Converts one image to PNG, JPEG, WebP, AVIF, GIF, TIFF, BMP or ICO (several icon sizes in one file) and returns the single converted file with the right Content-Type and file extension. Inputs: JPEG, PNG, WebP, GIF (animated GIFs and WebPs stay animated when the output is GIF or WebP), AVIF, TIFF, SVG and BMP. HEIC/HEIF input is not supported and returns 400. Optional controls: quality, background colour for formats without transparency, lossless, progressive JPEG, resize with fit modes, rotate and flip, grayscale, auto-orient from EXIF, keep or strip metadata, DPI, sharpen and blur. Options that do not apply to the chosen format are ignored. backgroundColor (hex such as #ffffff) fills transparent areas; JPEG (and 24-bit BMP) has no transparency, so it always flattens onto backgroundColor, white by default. Errors: 400 for a bad option (the message names it, for example an invalid backgroundColor), 413 when the file is over 15 MB, 422 when the file cannot be read as an image. Response headers X-Image-Width, X-Image-Height and X-Image-Frames describe the result. Trial keys: images up to 10 MB (over that returns 413 file_too_large; the call is not billed). Paid plans keep the larger limit of 15 MB. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "Image Processing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The image. Up to 15 MB."
                  },
                  "format": {
                    "type": "string",
                    "description": "Output format: png, jpeg (or jpg), webp, avif, gif, tiff, bmp or ico. image/... types such as image/webp are accepted too.",
                    "enum": [
                      "png",
                      "jpeg",
                      "webp",
                      "avif",
                      "gif",
                      "tiff",
                      "bmp",
                      "ico"
                    ]
                  },
                  "quality": {
                    "type": "number",
                    "description": "Quality for JPEG, WebP and AVIF (also palette PNG and JPEG-compressed TIFF). Either 0 to 1 (0.8) or 1 to 100 (80); 1 means 100. Defaults: JPEG 90, WebP 85, AVIF 60."
                  },
                  "backgroundColor": {
                    "type": "string",
                    "description": "Fill for transparent areas and for the padding of fit=contain: a hex colour such as #ffffff, ffffff or #fff, or a colour name such as white. Default white for JPEG and 24-bit BMP. For other formats it is only applied when you send it (GIF: send it to flatten transparency). Junk values return 400."
                  },
                  "lossless": {
                    "type": "boolean",
                    "description": "WebP and AVIF lossless mode. For PNG, false makes a smaller 256-colour palette PNG."
                  },
                  "progressive": {
                    "type": "boolean",
                    "description": "JPEG only: progressive (interlaced) scan."
                  },
                  "chromaSubsampling": {
                    "type": "string",
                    "description": "JPEG and AVIF colour detail: 4:4:4 (sharpest colour edges) or 4:2:0 (smaller file).",
                    "enum": [
                      "4:4:4",
                      "4:2:0"
                    ]
                  },
                  "pngCompressionLevel": {
                    "type": "number",
                    "description": "PNG zlib level 0 to 9 (default 6). Higher is smaller and slower.",
                    "minimum": 0,
                    "maximum": 9
                  },
                  "pngPalette": {
                    "type": "boolean",
                    "description": "PNG only: reduce to a palette of up to 256 colours for a much smaller file."
                  },
                  "effort": {
                    "type": "number",
                    "description": "CPU effort from 0 (fastest) to 10 (smallest file); clamped to the format's own range (WebP 0-6, AVIF 0-9, PNG and GIF 1-10). 'speed' is accepted as the same setting.",
                    "minimum": 0,
                    "maximum": 10
                  },
                  "width": {
                    "type": "number",
                    "description": "Target width in pixels (1 to 16384). With only one of width and height the other follows the picture's shape.",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "height": {
                    "type": "number",
                    "description": "Target height in pixels (1 to 16384).",
                    "minimum": 1,
                    "maximum": 16384
                  },
                  "fit": {
                    "type": "string",
                    "description": "How the picture meets width and height: inside (default; fits within the box, keeps the shape), contain (fits and pads to the exact box), cover (fills the box and crops the overflow), fill (stretches to the box), outside (at least as large as the box).",
                    "enum": [
                      "inside",
                      "contain",
                      "cover",
                      "fill",
                      "outside"
                    ],
                    "default": "inside"
                  },
                  "withoutEnlargement": {
                    "type": "boolean",
                    "description": "Never make the picture larger than the original."
                  },
                  "autoOrient": {
                    "type": "boolean",
                    "description": "Turn photos upright from their EXIF rotation flag. Default true."
                  },
                  "stripMetadata": {
                    "type": "boolean",
                    "description": "Remove EXIF, location, camera and colour-profile data. Default true; false keeps it where the output format can hold it."
                  },
                  "grayscale": {
                    "type": "boolean",
                    "description": "Convert to black and white."
                  },
                  "dpi": {
                    "type": "number",
                    "description": "Print resolution to write into PNG, JPEG, TIFF and BMP files, 1 to 2400. It does not change the pixel size.",
                    "minimum": 1,
                    "maximum": 2400
                  },
                  "rotate": {
                    "type": "number",
                    "description": "Rotate clockwise by a multiple of 90 degrees (90, 180, 270, -90). Not available for animated output."
                  },
                  "flip": {
                    "type": "boolean",
                    "description": "Mirror top to bottom."
                  },
                  "flop": {
                    "type": "boolean",
                    "description": "Mirror left to right."
                  },
                  "sharpen": {
                    "type": "string",
                    "description": "true, or an amount (sigma) from 0.3 to 100, to sharpen the result."
                  },
                  "blur": {
                    "type": "string",
                    "description": "true, or an amount (sigma) from 0.3 to 100, to blur the result."
                  },
                  "sizes": {
                    "type": "string",
                    "description": "ICO only: pixel sizes to pack into the icon, from 16, 32, 48, 64, 128, 256, comma separated. Default 16,32,48.",
                    "example": "16,32,48,256"
                  },
                  "bitDepth": {
                    "type": "number",
                    "description": "BMP only: 24 (default; transparency is flattened on the background colour) or 32 (keeps transparency).",
                    "enum": [
                      24,
                      32
                    ]
                  },
                  "tiffCompression": {
                    "type": "string",
                    "description": "TIFF only: none, lzw (default), deflate or jpeg.",
                    "enum": [
                      "none",
                      "lzw",
                      "deflate",
                      "jpeg"
                    ]
                  },
                  "animated": {
                    "type": "boolean",
                    "description": "Keep every frame of an animated GIF or WebP when the output is GIF or WebP. Default true; false converts only the first frame."
                  }
                },
                "required": [
                  "file",
                  "format"
                ]
              },
              "example": {
                "file": "sample.png",
                "format": "png"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, image/jpeg, 2,070 bytes.",
            "content": {
              "image/png, image/jpeg, image/webp, image/avif, image/gif, image/tiff, image/bmp or image/x-icon": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Image-Frames": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "1"
              },
              "X-Image-Height": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "480"
              },
              "X-Image-Width": {
                "schema": {
                  "type": "string"
                },
                "description": "Reported by the endpoint on every response",
                "example": "640"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "413": {
            "description": "Trial file cap exceeded (image over 10 MB, video or audio over 25 MB). JSON body: {error, code: \"file_too_large\", tier, limit_bytes, received_bytes}. Nothing is processed and the call is not billed. Paid plans keep their larger limits. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}