Qiniu(http://www.qiniu.com) is a cloud storage service, this package interages it with django framework.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


NOTE: This package is outdated and unmaintained, please take a look at other modern packages like django-qiniu-storage(https://github.com/glasslion/django-qiniu-storage), which uses a better appoarch by customizing django storage class.


This package interages Qiniu cloud storage with Django framework. You must install qiniu's python-sdk before using this package.


Add below lines in your django project's settings.py:

QINIU_ACCESS_KEY = 'your_key'
QINIU_SECRET_KEY = 'your_secret'
QINIU_BUCKET_DEFAULT = 'your_bucket_name'

How To Use

Use django-qiniu in your django project is very simple. First of all, your must copy django_qiniu directory to your PYTHON_PATH so you can import it.

1. Add Field To Your Model

To get started, you should add QiniuFileField or QiniuImageField to your models.py.

from django.db import models
from django_qiniu.fields import QiNiuImageField, QiniuFileField

def qiniu_key_maker_file(instance, filename):


    - instance, your model instance being saved
    - filename, original filename

    This function should return a string object which is the key of qiniu.

def qiniu_key_maker_user_image(instance, filename):

class Photo(models.Model):
    qiniu_file = QiNiuFileField(upload_to=qiniu_key_maker_file, null=True)
    qiniu_image = QiNiuImageField(upload_to=qiniu_key_maker_image, null=True)

QiniuFileField's __init__ method receives some parameters:

  • upload_to, a function to generate qiniu file key.
  • upload_bucket, bucket_name, if not given, will use settings.QINIU_BUCKET_DEFAULT as default.
  • domain, your customized qiniu static domain, will use ('%s.qiniudn.com' % upload_bucket) as default if not given.

QiniuImageField is a subclass of QiniuFileField and designed to store especially image files.

2. Save your uploaded file in views.py

Save your uploaded file to qiniu server is very simple:

f = request.FILES['file']
obj = Photo()
obj.qiniu_file = f
# Calling save method will upload this file to qiniu server and requires network
# connection

How to use saved qiniu instance?


You can get the file url by: instance.qiniu_file.url


For QiniuImageField, There is a convient method called get_image_view which is used to get thumbnails of your images, such as:

instance.qiniu_image.get_image_view(mode=1, width=280, height=280, quality=75)
instance.qiniu_image.get_image_view(mode=2, width=640, quality=75)

For more information, visit(http://docs.qiniu.com/api/v6/image-process.html)