prev/next

Thumbnails

Can I request thumbnails at specific intervals?

Want to request thumbnails every few seconds from a video? Choose the interval, then add '!' to the end of the integer. Add this to either your API call or use our web UI. XML below for reference:

 <format>  
<!-- Format fields -->  
<output>thumbnail</output>  
<time>[integer value]!</time>       
<width>[Width]</width>  
<height>[Size]</height>  
<!-- Destination fields -->  
</format>    
	 
 

Don't forget

 More -->

Want to request thumbnails every few seconds from a video? Choose the interval, then add '!' to the end of the integer. Add this to either your API call or use our web UI. XML below for reference:

<format>  
<!-- Format fields -->  
<output>thumbnail</output>  
<time>[integer value]!</time>       
<width>[Width]</width>  
<height>[Size]</height>  
<!-- Destination fields -->  
</format>    
	
 

Don't forget to give the first file a name in the API call, and also a destination! Files will not generate or deliver if these two items are not specified.

 
 
<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 1 time):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter

How can I request a thumbnail via API?

If you wish to request thumbnails via API, you've got a couple options:

1) You can request the thumbnail via timestamp (in seconds or percentage rate)

2) Want to request thumbnails at specific intervals? Use !5, for example, to request thumbnails at 5 second intervals

Please note:

- If your specified thumbnail width and height are
 More -->

If you wish to request thumbnails via API, you've got a couple options:

1) You can request the thumbnail via timestamp (in seconds or percentage rate)

2) Want to request thumbnails at specific intervals? Use !5, for example, to request thumbnails at 5 second intervals

Please note:

- If your specified thumbnail width and height are different from your video's aspect ratio, you may get black spaces added to the thumbnail image. 
- If you specify only width or height, the other will be calculated according to your video size.
- If both width and height are not specified, the thumbnail will result in the same size as your video. 
- JPEG is the only supported image format for thumbnail images.
 
If you have any questions specific to the formatting of the API request, please browse here:
http://www.encoding.com/api/category/category/complete_api_documentation#thumbnail_features
 
<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 1 time):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter

Thumbnail Template

Standard Thumbnail Template

 

 <format>
    <output>thumbnail</output>
    <time>5</time>
    <video_codec>mjpeg</video_codec>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <file_extension>jpg</file_extension>
 </format>

 

Standard Thumbnail Template

 

 <format>
    <output>thumbnail</output>
    <time>5</time>
    <video_codec>mjpeg</video_codec>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <file_extension>jpg</file_extension>
 </format>

 

<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 1 time):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter

I want to make thumbnails from my clips, but I don’t always know the length. What can I do?

So you want to make thumbnails from your clips, but you don't know the length, use the following:

Instead of <time>20</time> --> use a percentage-based value: <time>20%</time>.

So you want to make thumbnails from your clips, but you don't know the length, use the following:

Instead of <time>20</time> --> use a percentage-based value: <time>20%</time>.

<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 2 times):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter

Error generating thumbnail

This error message is generated when we could not generate a thumbnail from your video. Make sure that the timestamp you have chosen for us take the thumbnail exists in the video file, for example a thumbnail request with a timestamp of 35s in a 30s video will return this error.

This error message is generated when we could not generate a thumbnail from your video. Make sure that the timestamp you have chosen for us take the thumbnail exists in the video file, for example a thumbnail request with a timestamp of 35s in a 30s video will return this error.

<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 2 times):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter

Setting S3 permissions for thumbnails

AWS authentication access is currently not implemented for thumb_destination.
Alternatively you can create a separate task with output=thumbnail to use this
feature:
 
To quote our API documentation:
 
Instead of using thumb_ parameters within <format>, you can specify
separate encoding task with output = thumbnail:
 
   <format>
   <!--
 More -->
AWS authentication access is currently not implemented for thumb_destination.
Alternatively you can create a separate task with output=thumbnail to use this
feature:
 
To quote our API documentation:
 
Instead of using thumb_ parameters within <format>, you can specify
separate encoding task with output = thumbnail:
 
   <format>
   <!-- Format fields -->
       <output>thumbnail</output>
       <time>[Time]</time>    
       <width>[Width]</width>
       <height>[Size]</height>
   <!-- Destination fields -->
       <destination>[DestFile]</destination>
   </format>   
<-- Hide
tools: email  |  print  |  share  |  click to rate (rated 3 times):
  • BlinkList
  • Del.icio.us
  • Digg
  • Facebook
  • Google Bookmarks
  • LinkedIn
  • MySpace
  • Newsvine
  • Reddit
  • Sphinn
  • Technorati
  • Twitter