<?xml version="1.0"?>
<query>
<userid><<id>></userid> <!-- required-->
<userkey><<key>></userkey> <!-- required-->
<action>[Action]</action> <!-- required-->
<source>[SourceFile]</source> <!-- required -->
<format>
<output>[OutputFormat]</output> <!-- required -->
<audio_stream>
<use_stream_id>[SourceMediaAudioStreamID]</use_stream_id>
<natural_order>[yes|no]</natural_order>
<language>[ISO639-2 language identifier]</language>
<!-- Common audio settings -->
<channel>
<id>[OutputChannelID]</id>
<in>
<id>[SourceTrackID:SourceChannelID]</id>
<gain>[ChannelGainLevel]</gain>
</in>
<in>
<!-- input channel params -->
</in>
<split_layout>[SplitLayout]</split_layout>
</channel>
<channel>
<!-- audio channel params -->
</channel>
<normalize>[yes|no]</normalize>
<layout>[AudioLayoutName]</layout>
<audio_channels_number>[ChannelsNumber]</audio_channels_number>
<automix_channels>[yes|no]</automix_channels>
<lfe_low>[LfeLow]</lfe_low>
<lfe_high>[LfeHigh]</lfe_high>
<split_channels>[yes|no]</split_channels>
<validate>
<on_error>[pass|fail|report]</on_error>
<repair>[yes|no]</repair>
<loudness_diff>[LoudnessDiff]<loudness_diff>
<stereo_diff>[StereoDiff]</stereo_diff>
<side_diff>[SideDiff]</side_diff>
</validate>
<metadata_channel_layout>[LayoutMetaData]</metadata_channel_layout>
<upmix_channel_gain>
<fl>[FLGain]</fl>
<fr>[FRGain]</fr>
<fc>[FCGain]</fc>
<lfe>[LFGain]</lfe>
<sl>[SLGain]</sl>
<sr>[SRGain]</sr>
<bl>[BLGain]</bl>
<br>[BRGain]</br>
<bc>[BCGain]</bc>
</upmix_channel_gain>
<disposition>[visual_impaired|hearing_impaired]</disposition>
</audio_stream>
<!-- multiple audio_streams -->
<audio_stream>
<!-- audio_stream params -->
</audio_stream>
<!-- format params -->
</format>
</query>
{
"query": {
"userid": "<<id>>", // required
"userkey": "<<key>>", // required
"action": "[Action]", // required
"source": "[SourceFile]", // required
"format": {
"output": "[OutputFormat]", // required
"audio_stream": [
{
"use_stream_id": "[SourceMediaAudioStreamID]",
"natural_order": "[yes|no]",
"language": "[ISO639-2 language identifier]",
"channel": [
{
"id": "[OutputChannelID]",
"in": [
{
"id": "[SourceTrackID:SourceChannelID]",
"gain": "[ChannelGainLevel]"
},
{
// input channel params
}
],
"split_layout": "[SplitLayout]"
},
{
// audio channel params
}
],
"normalize": "[yes|no]",
"layout": "[AudioLayoutName]",
"audio_channels_number": "[ChannelsNumber]",
"automix_channels": "[yes|no]",
"lfe_low": "[LfeLow]",
"lfe_high": "[LfeHigh]",
"split_channels": "[yes|no]",
"validate": {
"on_error": "[pass|fail|report]",
"repair": "[yes|no]",
"loudness_diff": "[LoudnessDiff]",
"stereo_diff": "[StereoDiff]",
"side_diff": "[SideDiff]"
},
"metadata_channel_layout": "[LayoutMetaData]",
"upmix_channel_gain": {
"fl": "[FLGain]",
"fr": "[FRGain]',
"fc": "[FCGain]",
"lfe": "[LFGain]",
"sl": "[SLGain]",
"sr": "[SRGain]",
"bl": "[BLGain]",
"br": "[BRGain]",
"bc": "[BCGain]"
}
"disposition": "[visual_impaired|hearing_impaired]"
},
{
// audio_stream params
}
]
// format params
}
}
}
Parameter | Description | Allowed Values | Default Values |
---|---|---|---|
use_stream_id | Specify the source media stream ID. | Non negative integer number | By default # of **<audio_stream /> param will be used. |
natural_order | If set to yes then value of <use_stream_id /> will mean number of source's audio stream, not number of stream in all type streams list. | yes, no | no |
language | Specify the track language. | A language code in 3 lowercase letters according to ISO639-2. | none |
normalize | Enable the renormalization output track to avoid clipping noise. | yes, no | none |
layout | Specify the output channels layout. | One of these channel layouts: | none |
automix_channels | Automatically upmix or downmix audio stream to the specified number of channels in <audio_channels_number /> | yes, no | no |
lfe_low | LFE low cut off frequency | Integer number between 3 and 255 | 20 |
lfe_high | LFE high cut off frequency | Integer number between 3 and 512 | 120 |
split_channels | Mux PCM audio stream channels into output as individual tracks. | yes, no | no |
Output Audio Channel Parameters | |||
id | Specify the output channel ID. | Channel number or one of these channel names: | none |
split_layout | Set stream layout name for if <split_channels />set to yes | fl, fr, fc, lfe, bl, br, flc, frc, bc, sl, sr, tc, tfl, tfc, tfr, tbl, tbc, tbr, dl, dr, wl, wr, sdl, sdr, rsl, rsr, lw, rw, lfe2, lt, rt, - | none |
Input Audio Channel Parameters | |||
id | Specify input audio channel ID. | Input channel ID in format [track_id]:[channel_id] | none |
gain | Sepcify the input audio channel gain level. | Float positive number from 0 to 1 | none |
Validate Parameters | |||
metadata_channel_layout | Force channel layout value in the stream metadata | c – C, | none |
disposition | Audio stream disposition type | visual_impaired, hearing_impaired | none |
Upmix Channel Gain Parameters | |||
fl | Left channel gain | Float number between 0 and 1 inclusive | none |
fr | Right channel gain | Float number between 0 and 1 inclusive | none |
fc | Center channel gain | Float number between 0 and 1 inclusive | none |
lfe | LFE channel gain | Float number between 0 and 1 inclusive | none |
sl | Side left channel gain | Float number between 0 and 1 inclusive | none |
sr | Side right channel gain | Float number between 0 and 1 inclusive | none |
bl | Back left channel gain | Float number between 0 and 1 inclusive | none |
br | Back right channel gain | Float number between 0 and 1 inclusive | none |
bc | Back center channel gain | Float number between 0 and 1 inclusive | none |
Note for lfe_low and lfe_hight
<lfe_low /> and <lfe_hight /> parameters will be allied only in case of channel upmixing.
Note for split_channels
The <split_channels /> parameter available only for PCM audio codecs.
For metadata_channel_layout
The <metadata_channel_layout /> parameter available only for mov and dnxhd output formats.