Python API Client

Python integration handles uploads and file operations by wrapping Uploadcare Upload API and REST API. This comprehensive API client lets you use most of the Uploadcare features from within your Python app.



Upload features:

  • Upload files from local storage and URLs (up to 5 TB)
  • Multipart uploading for large files
  • Uploading network to speed uploading jobs (like CDN)

File management features:

  • Get file info and perform various operations (store/delete/copy) with them
  • Work with groups of files
  • Get info about account project
  • Manage webhooks

Security features:

  • Secure authentication
  • Secure uploads (signed uploads)


  • Python 2.7, 3.5, 3.6, 3.7, 3.8

If you're using pyuploadcare with Django, check .travis.yml for supported Python-Django combinations.


In order to install pyuploadcare, run these commands in CLI:

pip install pyuploadcare

or, if you prefer it the old way:

easy_install pyuploadcare

Usage example

Here is an example how to include Uploadcare ImageField into an existing Django project.

from django import forms
from django.db import models

from import ImageField
from import FileWidget

class Candidate(models.Model):
    photo = ImageField(blank=True, manual_crop="")

# optional. provide advanced widget options:
class CandidateForm(forms.Form):
    photo = ImageField(widget=FileWidget(attrs={
        'data-cdn-base': '',
        'data-image-shrink': '1024x1024',


$ pip install tox
$ tox