Custom Stills Service

The Custom Stills Service allows you create HD quality screen grabs from the stills picked for a video asset. As you can see below we created 4 different custom sizes the same still. Every video asset we add gets a still picked for it by our Production Staff. By default we do provide access to a 320×240 still for the video asset through the IVA OData API but with this new service you have the options of selecting the aspect ratio (16×9 or 4×3) and the size of the image. You create links to these stills very much like you do with making links to the trailers with our Video API. For this you will need your customer number and your secret token.

Custom Stills Example


All requests for images will follow these guide lines.

Application URL: or

When finished your URL should look like this:

Custom Stills Service Parameters

Publishedid (required) Unique identifier Internet Video Archive uses to reference both entertainment programs and Video Assets.
Width (optional)Desired Width of Image. Maximum width in our catalog is 1280. To get the source photo, do not pass this parameter (see: Height)
Height (optional)Desired height of Image. Maximum height in our catalog is 720. To get the source photo, do not pass this parameter (see: Width)
AspectRatio (required)Desired Aspect Ratio from our catalog of Image’s. We have two ratio’s available, 16×9(Widescreen) or 4×3(Standard).Choose aspect closest to your desired dimensions to ensure image

quality is maintained.
CustomerId (required)Unique id assigned by Video Detective. This ID is used for security and customization purposes. Ex: customerid=45678
e (required)Time when the URL expires. This value is calculated in the number of seconds from 01/01/1970 00:00:00 based on GMT. Click here for a Unix Time converter.
h (required) Hash code for the requested URL. This is the MD5 hash code your server will need to generate for each request for video. The MD5 hash is based on your security key and the

entire URL left of the hash code itself. If the application detects any of the parameters have been modified, the request will be denied. This URL encryption ensures that requests come only from the source.
alturlURL to content that IVA will redirect to when an image is not yet available.  By default, IVA will return a 1×1 image. By providing an alternate URL, developers can point to their own Image Not Available image to provide a consistent user interface.


For each request, If we do not have an image to match your request, we will attempt to generate the image for you. We will in the meantime return a 1×1 transparent pixel image.

The generated image will be available within a few minutes. This is limited only to content we have for the requested publishedid.

*Image Quality is dependent on availability of images in catalog.*

Click here for Encryption Documentation – This document describes how to create an MD5 hash and expiration of URLs to video content. There is also a hash code generator so that you can check your hash codes.


Images through this services are also available through HTTPS.



Requesting 1280×720 photo for movie UP with aspect ratio of 16×9 widescreen:

Requesting 960×720 Image for movie The Dark Knight with aspect ratio of 4×3 standard:

Requesting 400×320 photo for Tron Legacy asking for 4×3 standard:

Requesting 16×9 source photo (width/height variable) for Tron Legacy:

Requesting 4×3 source photo (width/height variable) for Tron Legacy:

Using OData API 2.0 and Custom Stills Service to Get HD Performer Photos

Did you know that IVA tags performers in each hand picked sill we select? We do! The example below shows you how to get all the IVA Published ID’s for the videos where a performer is tagged based on their Performer ID.

OData 2.0 API URL for Jennifer Lawrence, Performer ID: 115935$filter=PerformerId eq 115935 and HdTitlePhoto/AspectRatioId eq '16x9'&$expand=HdTitlePhoto&$select=HdTitlePhoto/publishedId&format=json&developerid={yourID}

The API call above will return a list of Published ID’s. Use those ID’s with the Custom Stills Service to get those photos.