Image Conversion API Documentation

Description: Documentation for an API that allows image conversion with resizing and quality adjustment.

Limitations

Image Processing Limit: Maximum image processing limit is 200 megapixels.
File Size Limit: Maximum file size limit is 10 MB.
Animated Image: Not supported as of the moment.
Rate Limit: 30 requests per minute.

Endpoints

POST /convert

Converts an uploaded image to a specified format, with optional resizing and quality adjustment.

Parameters

format (query): The output format of the image. Supported formats are jpeg, png, webp, gif, avif.
width (query, optional): The desired width of the output image.
height (query, optional): The desired height of the output image.
resize (query, optional): The desired percentage to resize the image.
quality (query, optional): The desired quality of the output image. Default is 80.

Request

The image file should be included in the request body with the key image.

Examples

Curl

curl -X POST -H "Content-Type: multipart/form-data" -F "image=@path/to/image.jpg" "https://ica.jeysi.dev/convert?format=png&width=500&height=500"

JavaScript (using `fetch`)

const formData = new FormData();
formData.append("image", fileInput.files[0]);
            
fetch("https://ica.jeysi.dev/convert?format=png&width=500&height=500", {
  method: "POST",
  body: formData,
})
  .then((response) => response.blob())
  .then((image) => {
    // Do something with the image
  });

Python (using `requests`)

import requests 
url = 'https://ica.jeysi.dev/convert?format=png&width=500&height=500'
files = {'image': open('path/to/image.jpg', 'rb')}
            
response = requests.post(url, files=files)
            
with open('output.png', 'wb') as out_file:
    out_file.write(response.content)

Responses

200 OK: The image was successfully converted. The response body will contain the converted image.
400 Bad Request: There was an issue with the request, such as an unsupported file type, no file uploaded, unsupported or no format specified, image exceeds complexity limits, or file size exceeds the limit. The response body will contain a JSON object with an error key providing more details.
429 Too Many Requests: The rate limit has been exceeded. The response body will contain a JSON object with an error key providing more details.
500 Internal Server Error: There was a server error during the conversion process. The response body will contain a JSON object with an error key providing more details.