Custom Stills Service 1.0
(Subscription Required)
The Custom Sill 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 320x240 still for the video asset through the IVA OData API but with this new service you have the options of selecting the aspect ratio (16x9 or 4x3) 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.
Documentation
Requests
All requests for images will follow these guide lines.
Application URL - http://images.internetvideoarchive.net/resizer or http://images.internetvideoarchive.net/resizer.jpg
When finished your URL should look like this:
http://images.internetvideoarchive.net/resizer?width=35&height=35&customerid=12345&aspectratio=4x3&publishedid=78568&e=1315876167&h=58128c241e9709163b814574d9761812
See "Application Parameters" below for descriptions and options for each parameter in the above link.
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.
| Application Parameters |
| Parameter | Description |
| Publishedid (required) | Unique identifier Internet Video Archive uses to reference both entertainment programs and Video Assets. |
| Width (required) | Desired Width of Image. Maximum width in our catalog is 1280. |
| Height (required) | Desired height of Image. Maximum height in our catalog is 720. |
| AspectRatio (required) | Desired Aspect Ratio from our catalog of Image's. We have two ratio's available, 16x9(Widescreen) or 4x3(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. |
| alturl (optional) | URL to content that IVA will redirect to when an image is not yet available. By default, IVA will return a 1x1 image. By providing an alternate URL, developers can point to their own Image Not Available image to provide a consistent user interface.
|
Notes:
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 1x1 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.*
Examples
Requesting 1280x720 photo for movie UP with aspect ratio of 16x9 widescreen:
http://images.internetvideoarchive.net/resizer?width=1280&height=720&customerid=12345&aspectratio=16x9&publishedid=75456&e=1315876167&h=58128c241e9709163b814574d9761812 |
Requesting 960x720 Image for movie The Dark Knight with aspect ratio of 4x3 standard:
http://images.internetvideoarchive.net/resizer?width=960&height=720&customerid=12345&aspectratio=4x3&publishedid=999961&e=1315876167&h=58128c241e9709163b814574d9761812 |
Requesting 400x320 photo for Tron Legacy asking for 4x3 standard:
http://images.internetvideoarchive.net/resizer?width=400&height=320&customerid=12345&aspectratio=16x9&publishedid=778984&e=1315876167&h=58128c241e9709163b814574d9761812 |