Lossless rotation (MOV format)

Copy Display Aspect Ratio from Source file

GoToMeeting input format added

Metadata 'copy' tag added

Auto de-interlacing added

MPEG-TS format added

Fade In / Fade Out effects

 <!-- Format fields -->
    ...
    <fade_in>[FadeInStart:FadeInDuration]</fade_in>
    <fade_out>[FadeOutStart:FadeOutDuration]</fade_out>
    ... 

Roku presets

S3 source option

Preset for Wowza Multi-bitrate

<format>
    <!-- Format fields -->
    <output>wowza_multibitrate</output>
    <bitrates>[CommaSeparatedList]</bitrates> 
    <sizes>[CommaSeparatedList]</sizes> 
    <!-- Destination fields -->
    <destination>[DestFile]</destination> <!-- REQUIRED -->
</format>  

New presets

Keep audio parameters

 <!-- Format fields -->
    ...
    <audio_codec>copy</audio_codec>
    ... 

If you specify audio_codec equal to 'copy', the options audio_channels_number, audio_sample_rate, audio_bitrate will be ignored and their values will be copied from your source file.

PNG with alpha-channel as Logo source

If your logo source is PNG with alpha-channel, set logo_mode equal to 1, to keep transparency.

<!-- Format fields -->
    ...
        <region>[us-east-1|us-west-1]</region>
    ...

<!-- Format fields -->
    ...
        <twin_turbo>yes</twin_turbo>
    ...

Muxing from different sources

Note: muxing is supported for only two sources now.
Sample XML to mux video from one source and audio from another one:

<?xml version="1.0"?>
<query>
  <action>AddMedia</action>
  <userid/>
  <userkey/>
  <source>[Video source]</source>
  <source>[Audio source]</source>

  <format>
    <output>muxer</output>
    <target>ntsc-dvd</target>
    <maps>0:0,1:0</maps>
  </format>
</query> 

Custom presets in API call

<!-- Format fields -->

        <output>[PRESET_NAME]</output>

Setting display aspect ratio

<!-- Format fields -->
        <set_aspect_ratio>[ASPECT_RATIO]</set_aspect_ratio>

Thumbnail time in intervals

Added a Noise Reduction filter

<format>
    <!-- Format fields -->
        <noise_reduction>luma_spatial:chroma_spatial:luma_temp</noise_reduction>
    </format> 

New MPEG-2 options

Audio codec MP2 added and set as default for MPEG-2.

    <format>
    <!-- Format fields -->
        <output>mpeg2</output>
        <keyframe>[12|15|25|30]</keyframe> 
        <bframes>[2|0]</bframes>
        <gop>[cgop|sgop]</gop>
    </format>   

Audio codec MP2 added and set as default for MPEG-2.

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid>
    <userkey>[UserKey]</userkey>
    <action>[Action]</action>
    <mediaid>[MediaID]</mediaid>
    <source>[SourceFile]</source>
    <source>[SourceFile1]</source> <!-- if multiple SourceFile added, they will be concatenated --> 
    ... 
    <source>[SourceFileN]</source>
    <notify>[NotifyURL]</notify>
    <instant>[yes|no]</instant>

With this feature, you can combine multiple source video files into one file.  To use this feature via the User Interface, you can add multiple video sources in the "Add Media" section and they will automatically combine into one file (in sequential order) during the encoding process. To utilize this concatenation feature via the API, you should use several <source> elements in your XML request which will be added sequentially during the encoding process.  In addition, you can use different source video URLs / locations (HTTP, FTP, S3, CloudFiles) along with different media properties for each source video (format, frame size, bitrate, codec, etc...).  [Read more]  For example:

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid>
    <userkey>[UserKey]</userkey>
    <action>[Action]</action>
    <mediaid>[MediaID]</mediaid>
    <source>[SourceFile]</source>
    <source>[SourceFile1]</source> <!-- if multiple SourceFile added, they will be concatenated --> 
    ... 
    <source>[SourceFileN]</source>

Multiple source (combine several video files to one file)

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid>
    <userkey>[UserKey]</userkey>
    <action>[Action]</action>
    <mediaid>[MediaID]</mediaid>
    <source>[SourceFile]</source>
    <source>[SourceFile1]</source> 
    <!-- if multiple SourceFile added, they will be concatenated --> 
    ... 
    <source>[SourceFileN]</source>

Multiple destination for each format (task)

Destination fields

<?xml version="1.0"?>
...
    <format>
        <id>[ID]</id>
        <status>[Status]</status>
        ...
        <destination>[URL]</destination>
        <destination_status>[Saved|Error (ErrorDescription)]</destination_status> 
        <destination>[URL_2]</destination>
        <destination_status>[Saved|Error (ErrorDescription)]</destination_status>
        ...
        <destination>[URL_N]</destination>
        <destination_status>[Saved|Error (ErrorDescription)]</destination_status>
    </format>

Encoding Result XML format

<format>  
    <output>[OutputFormat]</output>  
    <destination>[URL]</destination> <!-- Only in case of Status = Finished -->  
    <destination_status>[Saved|Error (ErrorDescription)]</destination_status>   
    <destination>[URL_2]</destination>  
    <destination_status>[Saved|Error (ErrorDescription)]</destination_status>  
    ...  
    <destination>[URL_N]</destination>  
    <destination_status>[Saved|Error (ErrorDescription)]</destination_status>  
    ...  
</format>   
</result>  

Thumbnail time in percentage rate

Destination fields

<format>
    <!-- Format fields -->
        <output>[iphone_stream|ipad_stream]</output>
        <bitrates>[CommaSeparatedList]</bitrates> 
        <framerates>[CommaSeparatedList]</framerates> 
        <keyframes>[CommaSeparatedList]</keyframes> 
        <segment_duration>[Duration]</segment_duration>
        <pack_files>[yes|no]</pack_files>
        <add_audio_only>[yes|no]</add_audio_only>
        <still_image>[no|each_segment|first_segment]</still_image>
        <still_image_time>[Time]</still_image_time>
        <still_image_size>[Size]</still_image_size>
    <!-- Destination fields -->
        <destination>[DestFile]</destination> <!-- REQUIRED -->
    </format>   

    <format>
    <!-- Format fields -->
        <output>iphone_stream</output>
        <bitrates>[CommaSeparatedList]</bitrates> 
        <segment_duration>[Duration]</segment_duration>
        <pack_files>[yes|no]</pack_files>
        <add_audio_only>[yes|no]</add_audio_only>
        <still_image>[no|each_segment|first_segment]</still_image>
        <still_image_time>[Time]</still_image_time>
        <still_image_size>[Size]</still_image_size>
    <!-- Destination fields -->
        <destination>[DestFile]</destination> <!-- optional -->
    </format>   

iPhone Streaming Features

    <format>
    <!-- Format fields -->
        <output>iphone_stream</output>
        <bitrates>[CommaSeparatedList]</bitrates> 
        <segment_duration>[Duration]</segment_duration>
        <pack_files>[yes|no]</pack_files>
    <!-- Destination fields -->
        <destination>[DestFile]</destination> <!-- optional -->
    </format> 

With the following specific parameters:

Image Converting Changes

<format>
    <!-- Format fields -->
        <output>image</output>
        <image_format>jpg</image_format>
        <resize_method>resize</resize_method>
        <size>560x420</size>
        <keep_aspect_ratio>yes</keep_aspect_ratio>
        <quality>75</quality>
        <sharpen_radius>1</sharpen_radius>
        <sharpen_sigma>0.5</sharpen_sigma>
        <remove_metadata>no</remove_metadata>
    <!-- Destination fields -->
        <destination>[DestFile]</destination>
    </format>   

With the following specific parameters:

Advanced H.264 Parameters

To see the example for parameters please follow this link

Simple mode

<?xml version="1.0"?>
<response>
    <id>[MediaID]</id>
    <userid>[UserID]</userid>
    <sourcefile>[SourceFile]</sourcefile>
    <status>[MediaStatus]</status>
    <notifyurl>[NotifyURL]</notifyurl>
    <created>[Date]</created>
    <started>[Date]</started>
    <finished>[Date]</finished>
    <prevstatus>[MediaStatus]</prevstatus>
    <downloaded>[Date]</downloaded>
    <uploaded>[Date]</uploaded>
    <time_left>[TotalTimeLeft]</time_left>
    <progress>[TotalProgress]</progress>
    <time_left_current>[StatusTimeLeft]</time_left_current>
    <progress_current>[StatusProgress]</progress_current>   
    <format>
        <id>[ID]</id>
        <status>[Status]</status>
        <created>[Date]</created>
        <started>[Date]</started>
        <finished>[Date]</finished>
        [FormatFields]
        <s3_destination>[TempS3Link]</s3_destination> <!-- optional -->
        <cf_destination>[TempCFLink]</cf_destination> <!-- optional -->
    </format>

    <format>
    …
    </format>
</response>

<query>
        <action>GetStatus</action>
        <userid>[UserID]</userid>
        <userkey>[UserKey]</userkey>
        <extended>yes</extended>
        <mediaid>[CommaSeparatedList]</mediaid>
</query>

<response>
<job>
    <id>[MediaID]</id>
    <userid>[UserID]</userid>
    <sourcefile>[SourceFile]</sourcefile>
    <status>[MediaStatus]</status>
    <notifyurl>[NotifyURL]</notifyurl>
    <created>[Date]</created>
    <started>[Date]</started>
    <finished>[Date]</finished>
    <prevstatus>[MediaStatus]</prevstatus>
    <downloaded>[Date]</downloaded>
    <filesize>[FileSize]</filesize>
    <processor>[AMAZON | RACKSPACE]</processor>
    <progress>[TotalProgress]</progress>
    <time_left>[TotalTimeLeft]</time_left>

    <format>
        <id>[ID]</id>
        <status>[Status]</status>
        <created>[Date]</created>
        <started>[Date]</started>
        <finished>[Date]</finished>
        <s3_destination>[TempS3Link]</s3_destination> <!-- optional -->
        <cf_destination>[TempCFLink]</cf_destination> <!-- optional -->
        <convertedsize>[FileSize]</convertedsize>
        <time_left>[TotalTimeLeft]</time_left>
        <progress>[TotalProgress]</progress>
        <time_left_current>[StatusTimeLeft]</time_left_current>
        <progress_current>[StatusPorgress]</progress_current>
        <file_size>[FileSize]</file_size>
    </format>

    <format>
    …
    </format>
</job>

<job>
...
</job>
...
</response>

MPEG-2 output

Using Rackspace Cloud Files as a source or a destination

Image Converting Features

    <format>
    <!-- Format fields -->
        <output>image</output>
        <image_format>jpg</image_format>
        <resize_method>resize</resize_method>
        <size>560x420</size>
        <keep_aspect_ratio>yes</keep_aspect_ratio>
        <quality>75</quality>
        <sharpen_radius>1</sharpen_radius>
        <sharpen_sigma>0.5</sharpen_sigma>
    <!-- Destination fields -->
        <destination>[DestFile]</destination>
    </format>   

AAC added as an option for FLV

Frame resizing ability added

Additional watermarking options

Logo fields

How mode and threshold work

logo_mode 0: The watermark picture works like this (assuming color intensities 0..0xFF): Per color do this (assuming logo_threshold is '808080'): If mask color is 0x80, no change to the original frame. If mask color is < 0x80 the absolute difference is subtracted from the frame. If result < 0, result = 0. If mask color is > 0x80 the absolute difference is added to the frame. If result > 0xFF, result = 0xFF. If threshold is 000000 the color value of watermark is added to the destination.

logo_mode 1: Per color do this: If mask color > threshold color then the watermark pixel is used.

<!-- Format fields -->
    ...
        <turbo>yes</turbo>
    ...

Audio output formats added

Adjusting audio volume

<!-- Format fields -->
    ...
        <audio_volume>[Volume]</audio_volume>
    ...

H.264 in FLV container

VP6 encoding moved under FLV format

VP6 Features

If you choose 'vp6' codec for 'flv' output format, your XML query will differ (less number of parameters are supported, see below):

<format>
            <output>flv</output>
            <video_codec>vp6</video_codec>
            <bitrate></bitrate> <!-- optional -->
            <size></size> <!-- optional -->
            <audio_bitrate>64k</audio_bitrate> <!-- optional -->
            <audio_sample_rate>44100<audio_sample_rate> <!-- optional -->
            <audio_channels_number>2</audio_channels_number> <!-- optional -->
            <framerate></framerate> <!-- optional -->
            <destination></destination> <!-- optional -->
</format>

Custom keyframe interval and video splicing added

<?xml version="1.0"?>
<query>
<!-- Format fields -->
        ...             
        <keyframe>[Keyframe Period (GOP)]</keyframe>
        <start>[Start From]</start>
        <duration>[Result Duration]</duration>
<!-- Destination fields -->
        ...             
<!-- Logo fields (OPTIONAL) -->     
        ...
    </format>
</query>

Format fields

<?xml version="1.0"?>
<query>
<!-- Format fields -->
        <output>[Output format]</output>
        <video_codec>[Video Codec]</video_codec>
        <audio_codec>[Audio Codec]</audio_codec>
        <bitrate>[Video bitrate]</bitrate>
        <audio_bitrate>[Audio bitrate]</audio_bitrate>
        <audio_sample_rate>[Audio quality]</audio_sample_rate>
        <size>[Size]</size>
        <crop_left>[Crop Left]</crop_left>
        <crop_top>[Crop Top]</crop_top>
        <crop_right>[Crop Right]</crop_right>
        <crop_bottom>[Crop Bottom]</crop_bottom>
        <thumb_time>[Thumb time]</thumb_time>
        <thumb_size>[Thumb size]</thumb_size>
        <add_meta>[yes/no]</add_meta>
        <rc_init_occupancy>[RC Occupancy]</rc_init_occupancy>
        <minrate>[Min Rate]</minrate>
        <maxrate>[Max Rate]</maxrate>
        <bufsize>[RC Buffer Size]</bufisize>
<!-- Destination fields -->
        ...             
<!-- Logo fields (OPTIONAL) -->     
        ...
    </format>
</query>
...

Format fields

Main fields

• AddMedia – add new media to user's media list, creates new items in a queue according to formats specified in XML
• AddMediaBenchmark - add new media to user's media list and set a flag for NOT processing it after downloading. Format fields could be specified as well. If NotifyURL is set, a notification will be sent after the media will have been ready for processing.
• UpdateMedia – replace information about existing media's formats. All old format items will be deleted, and the new ones added.
• ProcessMedia - start encoding of previously downloaded media (one that added with AddMediaBenchmark action)
• CancelMedia – delete specified media and all its items in queue
• GetMediaList – return list of user's media
• GetStatus – return information about selected user's media and all its items in queue
• GetMediaInfo - returns some video parameters of the specified media, if available

Destination fields

XML format for user's API request

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid>
    <userkey>[UserKey]</userkey>
    <action>[Action]</action>
    <mediaid>[MediaID]</mediaid>
    <source>[SourceFile]</source>
    <notify>[NotifyURL]</notify>
    <format>

<!-- Format fields -->
        <output>[Output format]</output>
        <video_codec>[Video Codec]</video_codec>
        <audio_codec>[Audio Codec]</audio_codec>
        <bitrate>[Video bitrate]</bitrate>
        <audio_bitrate>[Audio bitrate]</audio_bitrate>
        <audio_sample_rate>[Audio quality]</audio_sample_rate>
        <size>[Size]</size>
        <crop_left>[Crop Left]</crop_left>
        <crop_top>[Crop Top]</crop_top>
        <crop_right>[Crop Right]</crop_right>
        <crop_bottom>[Crop Bottom]</crop_bottom>
        <thumb_time>[Thumb time]</thumb_time>
        <thumb_size>[Thumb size]</thumb_size>
        <add_meta>[yes/no]</add_meta>

<!-- Destination fields -->
        <destination>[DestFile]</destination>
        <thumb_destination>[Thumb Dest]</thumb_destination>     

<!-- Logo fields (OPTIONAL) -->     
        <logo>
                <logo_source>[LogoURL]</logo_source>
                <logo_x>[LogoLeft]</logo_x>     
                <logo_y>[LogoTop]</logo_y>                      
        </logo>
    </format>
</query>

Logo fields

GetStatus action

<?xml version="1.0"?>
<response>
    <id>[MediaID]</id>
    <userid>[UserID]</userid>
    <sourcefile>[SourceFile]</sourcefile>
    <status>[MediaStatus]</status>
    <notifyurl>[NotifyURL]</notifyurl>
    <created>[Date]</created>
    <started>[Date]</started>
    <finished>[Date]</finished>
    <prevstatus>[MediaStatus]</prevstatus>
    <downloaded>[Date]</downloaded>
    <uploaded>[Date]</uploaded>
    <time_left>[TotalTimeLeft]</time_left>
    <progress>[TotalProgress]</progress>
    <time_left_current>[StatusTimeLeft]</time_left_current>
    <progress_current>[StatusProgress]</progress_current>   
    <format>
        <id>[ID]</id>
        <status>[Status]</status>
        <created>[Date]</created>
        <started>[Date]</started>
        <finished>[Date]</finished>
        [FormatFields]
        <s3_destination>[TempS3Link]</s3_destination>
    </format>

    <format>
    …
    </format>
</response>

Main fields

Destination fields

Note: Adding ?passive=yes to the FTP URL forces downloader/uploader use Passive Mode for FTP Transfer. Also, you can specify ?passive=no (the default) explicitly. It will take the same effect that if you don't specify this parameter at all.

Realtime status updates

GetStatus action

<?xml version="1.0"?>
<response>
    <id>[MediaID]</id>
    <userid>[UserID]</userid>
    <sourcefile>[SourceFile]</sourcefile>
    <status>[MediaStatus]</status>
    <notifyurl>[NotifyURL]</notifyurl>
    <created>[Date]</created>
    <started>[Date]</started>
    <finished>[Date]</finished>
    <downloaded>[Date]</downloaded>
    <time_left>[TotalTimeLeft]</time_left>
    <progress>[TotalProgress]</progress>
    <time_left_current>[StatusTimeLeft]</time_left_current>
    <progress_current>[StatusProgress]</progress_current>   
    <format>
        <id>[ID]</id>
        <status>[Status]</status>
        <created>[Date]</created>
        <started>[Date]</started>
        <finished>[Date]</finished>
        [FormatFields]
    </format>

    <format>
    …
    </format>
</response>

Notification after AddMediaBenchMark call

Main fields

• AddMedia – add new media to user's media list, creates new items in a queue according to formats specified in XML
• AddMediaBenchmark - add new media to user's media list and set a flag for NOT processing it after downloading. Format fields could be specified as well. If NotifyURL is set, a notification will be sent after the media will have been ready for processing.

The XML API Overview

GetMediaInfo action

<?xml version="1.0"?>
<response>
    <bitrate>364k</bitrate>
    <duration>175.21</duration>
    <video_codec>h264</video_codec>
    <frame_rate>23.98</frame_rate>  
    <audio_sample_rate>44100</audio_sample_rate>        
    <size>352x288</size>
</response>

Format fields

Format fields

Media Benchmarking API functions

Main fields

• AddMedia – add new media to user's media list, creates new items in a queue according to formats specified in XML
• AddMediaBenchmark - add new media to user's media list and set a flag for NOT processing it after downloading. Format fields could be specified as well.
• UpdateMedia – replace information about existing media's formats. All old format items will be deleted, and the new ones added.
• ProcessMedia - start encoding of previously downloaded media (one that added with AddMediaBenchmark action)
• CancelMedia – delete specified media and all its items in queue
• GetMediaList – return list of user's media
• GetStatus – return information about selected user's media and all its items in queue
• GetMediaInfo - returns some video parameters of the specified media, if available

Added:
GetMediaInfo action

<?xml version="1.0"?>
<response>
    <bitrate>364k</bitrate>
    <duration>175.21</duration>
    <video_codec>h264</video_codec>
    <size>352x288</size>
</response>

Multiple Thumbnail Support

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

AddMedia action

<?xml version="1.0"?>
<response>
    <message>Added</message>
    <MediaID>[MediaID]</MediaID>
</response>

VP6 Features

    <format>
    <!-- Format fields -->
        <output>vp6</output>
        <profile>[VP6 profile]</profile>
        <size>[Size]</size>
    <!-- Destination fields -->
        <destination>[DestFile]</destination>
    </format>   

destination [required] - The destination URL to put the encoded file.