Image to Image Python Examples

These examples demonstrate common Image to Image API workflows in Python.

Basic examples

PNG file to JPEG file

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and save the result to a file.
    client.convertFileToFile('/path/to/logo.png', 'logo.jpg')

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

PNG file to in-memory JPEG

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and store the result in the `image` variable.
    image = client.convertFile('/path/to/logo.png')

    # at this point the "image" variable contains JPG raw data and
    # can be sent in an HTTP response, saved to a file, etc.

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

PNG file to JPEG stream

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Create an output stream for the conversion result
    output_stream = open('logo.jpg', 'wb')

    # run the conversion and write the result to the output stream.
    client.convertFileToStream('/path/to/logo.png', output_stream)

    # Close the output stream.
    output_stream.close()

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

PNG url to JPEG file

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and save the result to a file.
    client.convertUrlToFile('https://pdfcrowd.com/static/images/logo.png', 'logo.jpg')

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

PNG url to in-memory JPEG

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and store the result in the `image` variable.
    image = client.convertUrl('https://pdfcrowd.com/static/images/logo.png')

    # at this point the "image" variable contains JPG raw data and
    # can be sent in an HTTP response, saved to a file, etc.

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

PNG url to JPEG stream

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Create an output stream for the conversion result
    output_stream = open('logo.jpg', 'wb')

    # run the conversion and write the result to the output stream.
    client.convertUrlToStream('https://pdfcrowd.com/static/images/logo.png', output_stream)

    # Close the output stream.
    output_stream.close()

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

In-memory PNG to JPEG file

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and save the result to a file.
    client.convertRawDataToFile(open('/path/to/logo.png', 'rb').read(), 'logo.jpg')

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

In-memory PNG to in-memory JPEG

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Run the conversion and store the result in the `image` variable.
    image = client.convertRawData(open('/path/to/logo.png', 'rb').read())

    # at this point the "image" variable contains JPG raw data and
    # can be sent in an HTTP response, saved to a file, etc.

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

In-memory PNG to JPEG stream

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')

    # Create an output stream for the conversion result
    output_stream = open('logo.jpg', 'wb')

    # run the conversion and write the result to the output stream.
    client.convertRawDataToStream(open('/path/to/logo.png', 'rb').read(), output_stream)

    # Close the output stream.
    output_stream.close()

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

Get info about the current conversion

import pdfcrowd
import sys

try:
    # Create an API client instance.
    client = pdfcrowd.ImageToImageClient('demo', 'demo')

    # Configure the conversion.
    client.setOutputFormat('jpg')
    client.setDebugLog(True)

    # Run the conversion and save the result to a file.
    client.convertFileToFile('/path/to/logo.png', 'logo.jpg')
    
    # print URL pointing to the debug log for this request.
    print('Debug log url: {}'.format(client.getDebugLogUrl()))
    
    # print number of conversion credits remaining in your account.
    print('Remaining credit count: {}'.format(client.getRemainingCreditCount()))
    
    # print number of credits consumed for this conversion.
    print('Consumed credit count: {}'.format(client.getConsumedCreditCount()))
    
    # print unique identifier assigned to this conversion job.
    print('Job id: {}'.format(client.getJobId()))
    
    # print size of the output data in bytes.
    print('Output size: {}'.format(client.getOutputSize()))

except pdfcrowd.Error as why:
    sys.stderr.write('PDFCrowd Error: {}\n'.format(why))
    raise

Django examples

PNG file to JPEG in Django

import urllib.parse
from django.http import HttpResponse
from django.views.decorators.http import require_POST
import pdfcrowd

# The recommended method is POST.
@require_POST
def convert(request):
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Set HTTP response headers.
        response = HttpResponse(content_type='image/jpeg')
        response['Cache-Control'] = 'max-age=0'
        response['Accept-Ranges'] = 'none'
        response['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')

        # run the conversion and write the result to the output stream.
        client.convertFileToStream('/path/to/logo.png', response)
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return HttpResponse(
            why, status=why.getStatusCode(), content_type='text/plain')

PNG url to JPEG in Django

import urllib.parse
from django.http import HttpResponse
from django.views.decorators.http import require_POST
import pdfcrowd

# The recommended method is POST.
@require_POST
def convert(request):
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Set HTTP response headers.
        response = HttpResponse(content_type='image/jpeg')
        response['Cache-Control'] = 'max-age=0'
        response['Accept-Ranges'] = 'none'
        response['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')

        # run the conversion and write the result to the output stream.
        client.convertUrlToStream('https://pdfcrowd.com/static/images/logo.png', response)
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return HttpResponse(
            why, status=why.getStatusCode(), content_type='text/plain')

In-memory PNG to JPEG in Django

import urllib.parse
from django.http import HttpResponse
from django.views.decorators.http import require_POST
import pdfcrowd

# The recommended method is POST.
@require_POST
def convert(request):
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Set HTTP response headers.
        response = HttpResponse(content_type='image/jpeg')
        response['Cache-Control'] = 'max-age=0'
        response['Accept-Ranges'] = 'none'
        response['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')

        # run the conversion and write the result to the output stream.
        client.convertRawDataToStream(open('/path/to/logo.png', 'rb').read(), response)
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return HttpResponse(
            why, status=why.getStatusCode(), content_type='text/plain')

Flask examples

PNG file to JPEG in Flask

import urllib.parse
from flask import Flask, Response
import pdfcrowd

app = Flask(__name__)

# The recommended method is POST.
@app.route('/', methods=['POST'])
def convert():
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Run the conversion and store the result in the `image` variable.
        image = client.convertFile('/path/to/logo.png');

        # Send the result and set HTTP response headers.
        response = Response(image, mimetype='image/jpeg')
        response.headers['Cache-Control'] = 'max-age=0'
        response.headers['Accept-Ranges'] = 'none'
        response.headers['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return Response(
            str(why), status=why.getStatusCode(), mimetype='text/plain')

PNG url to JPEG in Flask

import urllib.parse
from flask import Flask, Response
import pdfcrowd

app = Flask(__name__)

# The recommended method is POST.
@app.route('/', methods=['POST'])
def convert():
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Run the conversion and store the result in the `image` variable.
        image = client.convertUrl('https://pdfcrowd.com/static/images/logo.png');

        # Send the result and set HTTP response headers.
        response = Response(image, mimetype='image/jpeg')
        response.headers['Cache-Control'] = 'max-age=0'
        response.headers['Accept-Ranges'] = 'none'
        response.headers['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return Response(
            str(why), status=why.getStatusCode(), mimetype='text/plain')

In-memory PNG to JPEG in Flask

import urllib.parse
from flask import Flask, Response
import pdfcrowd

app = Flask(__name__)

# The recommended method is POST.
@app.route('/', methods=['POST'])
def convert():
    try:
        # Create an API client instance.
        client = pdfcrowd.ImageToImageClient('demo', 'demo')

        # Configure the conversion.
        client.setOutputFormat('jpg')

        # Run the conversion and store the result in the `image` variable.
        image = client.convertRawData(open('/path/to/logo.png', 'rb').read());

        # Send the result and set HTTP response headers.
        response = Response(image, mimetype='image/jpeg')
        response.headers['Cache-Control'] = 'max-age=0'
        response.headers['Accept-Ranges'] = 'none'
        response.headers['Content-Disposition'] = "attachment; filename*=UTF-8''" + urllib.parse.quote('logo.jpg', safe='')
        return response
    except pdfcrowd.Error as why:
        # Send the error in the HTTP response.
        return Response(
            str(why), status=why.getStatusCode(), mimetype='text/plain')