Getting started with the Image API
There are many ways to make a IIIF Image available which is both a big advantage but also can add complexity. The decision on which option to go for depends on your institution or personal use case. IIIF is able to be used by single researchers up to National institutions and so there are setups to handle each individual case. Below is a list of options with benefits and issues.
In a 2018 survey we asked what people were using to provide the Image API and these were the results:
Respondents were mostly from within the IIIF community and there is a weighting to larger institutions. Most respondents had installed one of the Image Servers but others are using hosted and DAMS solutions.
For the purposes of this workshop we will ask you to use the Internet Archive hosted option. You are welcome to follow the guides on installing Cantaloupe and a level0 image server but these are optional extensions.
Vendor / DAMS
For an institution, the best solution is probably to use existing software that you already have. If you have a DAMS system or repository this may already implement IIIF and if it doesn't the best solution maybe to talk them into implementing. This reduces the duplication of images between your image management system and your IIIF Image Server. This solution may not be suitable to individual researchers or institutions who don't have these kind of systems.
- Where are your images stored now?
- Examples of IIIF supporting Vendors include:
- OCLC ContentDM,
- Veridian and many others.
We have a page on the IIIF website that lists some of the major digital asset management (DAMs), collections management, and repository tools that support IIIF.
Hosting allows you to upload your images to a service that provides a IIIF Image API. These hosting providers run the IIIF Image Servers mentioned below for you and provide interfaces for uploading and managing images. These are good solutions for individual researchers who want to make a few images available and for the commercial providers they also provide a good solution for mid to large sized institutions. For the commercial providers there are costs involved and you will have to weigh up the costs against the costs of running and supporting the Open Source Image servers in the next section.
Free hosting from the Internet Archive - Guide
- Klokan iiifhosting.com - (Guide from another workshop) if its of interest.
- Digirati DCLS platform
IIIF Image server
There are many Open Source IIIF Image servers available. These are free to use but require infrastructure and staff time to setup and maintain. The three main ones in use are detailed below. They can be setup to serve 10s to millions of images. For the individual researcher or small institution the overhead with installing and maintaining these services may be too much.
- Main ones:
- IIP Image - written in C
- Loris - python
- Cantaloupe - Java
The final option is to use a feature of the Image API where all of the derivative images can be extracted and made available without an image server. There are many ways to get access to free or cheap web hosting. This solution has many steps but can provide a very low cost option for providing access to IIIF Images for researchers and smaller institutions. One thing it doesn't support is custom regions so for example the following level0 image:
Only has a limited number of sizes and regions defined. Enough to work in a zoomable viewer but it won't work with things like the UCD Image Cropper which can select any region.
You can see the generated files on github. There is also a blog on how to use IIIF level 0 images. IIIF from Scratch.
You can optionally follow this guide to create your own level 0 images. Workshop Guide
Once you have created your level 0 images you can make them available with the following example services:
For an idea of costs, the Amazon S3 costs are available here. For a ball park figure 2,000 images would cost around a $1 a month.
Once the images are generated there is little maintenance required and the solution scales to millions of users.