Convert Base64 to Image

Convert a Base64-encoded string back to an image file in various formats.

Request Parameters

Response

Returns the binary image data in the specified format. The Content-Type header will be set to the appropriate MIME type for the image format.

Example Request

    // example.sh
curl -X POST "https://oyyi.xyz/api/image/from-base64" \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "base64_str": "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/...",
    "output_format": "png"
  }' \
  --output converted_image.png
  

Example with Python

    // from_base64.py
import requests
import base64

url = "https://oyyi.xyz/api/image/from-base64"

# Example: Read a Base64 string from a text file
with open('base64_image.txt', 'r') as f:
    base64_string = f.read().strip()

# Or use a Base64 string directly
# base64_string = "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/..."

data = {
    "base64_str": base64_string,
    "output_format": "png"
}

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

# Save the converted image
with open('converted_image.png', 'wb') as f:
    f.write(response.content)
  

Example with JavaScript

    // from_base64.js
// Using fetch API
const base64String = "/9j/4AAQSkZJRgABAQEAYABgAAD/2wBDAAIBAQIBAQICAgICAgICAwUDAwMDAwYEBAMFBwYHBwcGBwcICQsJCAgKCAcHCg0KCgsMDAwMBwkODw0MDgsMDAz/...";

fetch('https://oyyi.xyz/api/image/from-base64', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    base64_str: base64String,
    output_format: 'png'
  })
})
.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 = 'converted_image.png';
  a.click();

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

Supported Output Formats

How It Works

The from-base64 endpoint converts a Base64-encoded string back to an image file:

1. Input Parsing: The Base64 string is parsed, removing any data URI prefix if present.
2. MIME Type Detection: If the input is a data URI, the MIME type is extracted to determine the original format.
3. Base64 Decoding: The Base64 string is decoded back to binary data.
4. Image Loading: The binary data is loaded as an image.
5. Format Conversion: If an output_format is specified, the image is converted to that format.
6. Quality Adjustment: For JPEG or WebP output, the quality parameter is applied.
7. Response Generation: The image is returned as binary data with the appropriate Content-Type header.

The result is an image file that can be saved, displayed, or further processed.

Data URI Format

Error Responses

Notes

• The endpoint automatically handles both plain Base64 strings and complete data URIs.
• If the Base64 string contains padding characters (=), they can be included or omitted.
• When converting between formats, some information may be lost. For example, converting from PNG to JPEG will lose transparency.
• The quality parameter only affects JPEG and WebP output formats. It is ignored for other formats.
• The maximum decoded image size allowed is 50MB.
• For animated GIFs or multi-frame images, only the first frame will be processed.
• If the Base64 string is invalid or does not represent an image, a 400 or 415 error will be returned.

Use Cases

• Converting Base64-encoded images from APIs back to image files
• Saving images embedded in HTML or CSS as separate files
• Converting between image formats (e.g., from JPEG to PNG)
• Extracting images from data URIs
• Processing Base64-encoded images from form submissions
• Saving images from canvas elements in web applications
• Converting Base64-encoded images from databases to file storage
• Implementing "Save As" functionality for Base64-embedded images