Image Resizer/Optimizer API

This API endpoint was made by Automation Tribe.
Join our community at https://www.skool.com/automation-tribe.

This API resizes and optimizes images provided via URL or direct upload. Input is via form-data (multipart/form-data).

Logging: On errors, a log file (e.g., image_resize_timestamp.log) will be created in the 'logs' subfolder of temp_image_files.

Server Status

• ✅PHP GD Extension: Installed ✅ (2.3.3)
• ✅PHP cURL Extension: Installed ✅
• ✅Temp Dir (temp_image_files): Writable ✅

API Usage

Endpoint

https://n8achraf.com/image-resizer.php

HTTP Method

POST

Content Type

multipart/form-data

Form Data Parameters:

• image_file (Optional if image_url provided): The image file to upload.
• image_url (Optional if image_file provided): URL of the image to process.
• width (Optional): Desired width in pixels. Aspect ratio maintained if only width is set.
• height (Optional): Desired height in pixels. Aspect ratio maintained if only height is set. (If both width and height are set, image is resized to those exact dimensions, potentially altering aspect ratio).
• quality (Optional): Output quality (0-100). Default: 85 for JPEG/WebP. (For PNG, this controls compression level).
• format (Optional): Desired output format (jpeg, png, webp). Default: jpeg.
• output_filename (Optional): Desired base name for the output file (e.g., "my_custom_image"). Extension will be added based on 'format'. Default: "processed_image_timestamp_random".

You must provide either image_file or image_url.

Success Response

On success, the API returns the processed image directly with the appropriate Content-Type header (e.g., image/jpeg) and a Content-Disposition: inline; filename="your_filename.jpg" header. You can display this image directly or save it.

Error Response (JSON)

{
    "error": "Descriptive error message."
}

How to Use (cURL Example)

Using image_url with custom filename:

curl -X POST 'https://n8achraf.com/image-resizer.php' \
  -F "image_url=https://www.php.net/images/logos/new-php-logo.png" \
  -F "width=300" \
  -F "format=jpeg" \
  -F "quality=80" \
  -F "output_filename=php_logo_resized" \
  -o php_logo_resized.jpg

Copy cURL (image_url)

Uploading a local file (replace path/to/your/image.png):

curl -X POST 'https://n8achraf.com/image-resizer.php' \
  -F "image_file=@path/to/your/image.png" \
  -F "height=200" \
  -F "format=webp" \
  -F "output_filename=my_uploaded_image" \
  -o my_uploaded_image.webp

Copy cURL (image_file)

Important Notes

• PHP GD Extension: This is the core of the image processing. Ensure it's enabled and supports the input/output formats you need.
• Memory & Execution Time: Processing large images can be resource-intensive. Adjust script constants and server PHP limits if needed.
• WebP Support: Depends on your GD library's compilation.
• Filename Sanitization: Custom output filenames are sanitized to prevent security issues.

Refresh Status & Documentation