Flip Image

Mirror an image horizontally, vertically, or both to create a flipped version.

Request Parameters

Response

Returns the flipped image in the specified or original format.

Example Request

    // example.sh
curl -X POST "https://oyyi.xyz/api/image/flip"   -H "accept: application/json" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@image.jpg" \
  -F "mode=horizontal" \
  --output flipped.jpg
  

Example with Python

    // flip.py
import requests

url = "https://oyyi.xyz/api/image/flip"

files = {
    'file': open('image.jpg', 'rb')
}

data = {
    'mode': 'horizontal'
}

response = requests.post(url, files=files, data=data)

# Save the flipped image
with open('flipped.jpg', 'wb') as f:
    f.write(response.content)
  

Example with JavaScript

    // flip.js
// Using fetch API
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('direction', 'horizontal');

fetch('https://oyyi.xyz/api/image/flip', {
  method: 'POST',
  body: formData
})
.then(response => response.blob())
.then(blob => {
  // Create a URL for the blob
  const url = URL.createObjectURL(blob);

  // Create a link to download the image
  const a = document.createElement('a');
  a.href = url;
  a.download = 'flipped.jpg';
  a.click();

  // Clean up by revoking the URL
  URL.revokeObjectURL(url);
})
.catch(error => console.error('Error:', error));
  

Flip Directions

How It Works

The flip endpoint mirrors an image along one or both axes:

1. Image Loading: The uploaded image is loaded into memory.
2. Flip Operation: Depending on the direction parameter:
   • Horizontal: Each pixel's x-coordinate is mirrored across the vertical center line of the image.
   • Vertical: Each pixel's y-coordinate is mirrored across the horizontal center line of the image.
   • Both: Both horizontal and vertical flips are applied, effectively rotating the image 180 degrees.
3. Format Conversion: If an output_format is specified, the flipped image is converted to that format.
4. Quality Setting: For lossy formats (JPEG, WebP), the specified quality level is applied.

The result is an image that has been mirrored according to the specified direction.

Visual Representation

Original:           Horizontal Flip:     Vertical Flip:       Both:
+---+---+           +---+---+           +---+---+           +---+---+
| A | B |           | B | A |           | C | D |           | D | C |
+---+---+    →      +---+---+    →      +---+---+    →      +---+---+
| C | D |           | D | C |           | A | B |           | B | A |
+---+---+           +---+---+           +---+---+           +---+---+
      

Error Responses

Notes

• Flipping is a lossless transformation that preserves the original image quality.
• The dimensions of the image remain unchanged after flipping.
• Flipping is often used to correct mirror images or to create symmetrical compositions.
• For images with text or recognizable elements (like faces), horizontal flipping will make the text appear backward and may look unnatural.
• For animated GIFs, all frames will be flipped if the output format is also GIF.
• The maximum file size allowed is 50MB.
• This operation preserves the alpha channel (transparency) if present in the original image and the output format supports it.

Use Cases

• Correcting mirror images from front-facing cameras
• Creating symmetrical compositions for design purposes
• Adjusting the direction of elements in an image for layout requirements
• Creating variations of logos or design elements
• Correcting scanned images that were placed incorrectly on the scanner
• Creating reflection effects when combined with other image processing operations
• Implementing image editing functionality in applications
• Creating before/after comparisons with mirrored images