The Image API provides for a standardized way to request and deliver images. Having this standardization allows both browser and server applications to reuse software and provide a consistent experience for requesting images.

I will be presenting this Google slide deck but will include all links here so you can follow along.


Glen Robson, IIIF Technical Coordinator

National Library of Wales links:

Pre-IIIF Viewers

Example from Ben Albritton's blog Fellow Travelers: The Canterbury Tales and IIIF

Image API

Latest version of the Image API is available at http://iiif.io/api/image/2.1/.

Image API demonstration

Many of these examples are from Tom Crane's excellent blog series.

Image API Exercises

Look at the following and play around with the parameters:


In pairs answer the following questions:

  1. Given the following image URL: https://iiif.lib.ncsu.edu/iiif/mc00198-008-ff0051-000-001_0001/full/512,/0/default.jpg what would be the URL for the info.json?
  2. What is the width and height of the biggest size image?
  3. Construct a URL that:
    • Shows the full image
    • is 512px wide
    • is upside down
    • gray scale
    • has a format of png
  4. What formats can you request for this image?

Looking at the IIIF API Specification https://iiif.io/api/image/2.1/

  1. What status code should be returned if you ask for a format the image server doesn't support?
  2. What does max image size mean? How does it differ to full? When might you use this?

Given the following info.json:

    "@context": "http://iiif.io/api/image/2/context.json",
    "@id": "http://example.com/iiif/image/2",
    "@type": "iiif:Image",
    "protocol": "http://iiif.io/api/image",
    "width": 400,
    "height": 400,

and image:


HINT: remember 0,0 is the top left of the image.

  1. What would the URL be to cut out the green quarter?
  2. What would the URL be to cut out the white quarter?

Bonus points:

Given the following info.json: https://iiif.lib.ncsu.edu/iiif/mc00198-008-ff0051-000-001_0001/info.json

  1. How many tiles would you need to show the full image?

If you finish have a look at http://puzzle.mikeapps.me/

Last modified by Glen Robson 2019-06-02 19:03:34
Created by Jack Reed 2018-04-18 22:07:03

results matching ""

    No results matching ""