05 June 2012

Dolby AAC, HE-AAC, HE-AACv2

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <audio_codec>[dolby_aac, dolby_heaac, dolby_heaacv2]</audio_codec>
        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "audio_codec": "[dolby_aac, dolby_heaac, dolby_heaacv2]"
        }
    }
}

Dolby AAC codec, and AAC profiles HE-AAC, HE-AACv2 compatible with the following presets:appletv, fl9, flv, hds, ipad, ipadstream, iphone, iphone_stream, ipod, kindle_fire, m4a, mov, mp4, psp, roku*, smooth_streaming, wowza, wowza_multibitrate

Dolby Digital Plus Audio Codec

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <audio_codec>eac3</audio_codec>
        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "audio_codec": "eac3"
        }
    }
}

Dolby Digital Plus Audio Codec compatible with Mov format.

Dolby Digital Plus Audio Preset

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>eac3</output>

        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "eac3"
        }
    }
}

Format Name	Description	Allowed Values	Default Values
(required) output	Format type	eac3	None.

HTTP Dynamic Streaming

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>hds</output>
        <bitrates>[CommaSeparatedList]</bitrates> 
        <sizes>[CommaSeparatedList]</sizes> 
        <pack_files>[yes|no]</pack_files> 
        <!-- Destination fields -->
        <destination>[DestFile]</destination> <!-- REQUIRED -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "hds",
            "bitrates": "[CommaSeparatedList]",
            "sizes": "[CommaSeparatedList]",
            "pack_files": "[yes|no]",
            "destination": "[DestFile]"
        }
    }
}

Format Name	Description	Allowed Values
bitrates Comma separated list of video bitrates	One or more valid bitrate values separated by commas	300k,600k,1200k,2400k
sizes Comma separated list of video sizes	One or more valid size values separated by commas	None
pack_files Whether to pack resulting files to a single tarball	yes, no	yes

Smooth Streaming

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <output>smooth_streaming</output>
        <bitrates>[CommaSeparatedList]</bitrates> 
        <sizes>[CommaSeparatedList]</sizes> 
        <pack_files>[yes|no]</pack_files> 
        <!-- Destination fields -->
        <destination>[DestFile]</destination> <!-- REQUIRED -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "output": "smooth_streaming",
            "bitrates": "[CommaSeparatedList]",
            "sizes": "[CommaSeparatedList]",
            "pack_files": "[yes|no]",
            "destination": "[DestFile]"
        }
    }
}

Format Name	Description	Allowed Values
bitrates Comma separated list of video bitrates	One or more valid bitrate values separated by commas	300k,600k,1200k,2400k
sizes Comma separated list of video sizes	One or more valid size values separated by commas	224x0,448x0,768x0,1280x0
pack_files Whether to pack resulting files to a single tarball	yes, no	yes

Stop media tasks

<?xml version="1.0"?>
<query>
    <!-- Main fields -->
    <userid><<id>></userid>
    <userkey><<key>></userkey>
    <action>StopMedia</action>
    <mediaid>[MediaID]</mediaid>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "StopMedia",
        "mediaid": "[MediaID]"
    }
}

Action	Description
StopMedia

Notify Encoding Errors URL

<?xml version="1.0"?>
<query>
    <!-- Main fields -->
    <userid><<id>></userid>
    <userkey><<key>></userkey>
    <action>AddMedia</action>
    <notify_encoding_errors>[NotifyEncodingErrorURL]</notify_encoding_errors>
    <format>
        <!-- Format fields -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "AddMedia",
        "notify_encoding_errors": "[NotifyEncodingErrorURL]",
        "format": {}
    }
}

Action	Description
NotifyEncodingErrorURL

Start/Duration parameters in sub-second intervals

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <start>1.5</start> 
        <duration>7.5</duration>
        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "start": "1.5",
            "duration": "7.5"
        }
    }
}

Format Name	Description	Allowed Values	Default Values
start	Start encoding from (sec)	positive float value	None
duration	Duration (sec)	positive float value	None

Audio normalization

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <audio_normalization>[0-100]</audio_normalization>
        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "audio_normalization": "[0-100]"
        }
    }
}

Format Name	Description	Allowed Values	Default Values
audio_normalization This option specifies that a gain should be applied so that the final dialogue normalization value of the audio signal is equal to the specified value.	Non-negative integer from 0 to 100	None

Frame Rate Upper Threshold

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required-->
    <userkey><<key>></userkey> <!-- required-->
    <action>[Action]</action> <!-- required-->
    <format>
        <!-- Format fields -->
        <framerate_upper_threshold>[Frame Rate Upper Threshold]</framerate_upper_threshold>
        <!-- ... -->
    </format>
</query>

{
    "query": {
        "userid": "<<id>>",
        "userkey": "<<key>>",
        "action": "[Action]",
        "format": {
            "framerate_upper_threshold": "[Frame Rate Upper Threshold]"
        }
    }
}

Format Name	Description	Allowed Values	Default Values
framerate_upper_threshold	If source frame rate lower then framerate_upper_threshold, then source frame rate will be used	Any non-zero integer or N/M where N and M are non-zero integers	None