Advanced Encoding Settings

Have a ton of videos that just require lossless rotation? Did someone have too much fun with the iPhone and shoot everything portrait instead of landscape?

Try this on for size. Lossless rotation for use with .mov --> .mov files only.

<format>
  <output>mov</output>
  <destination>[Destination]</destination>
  <rotate>0</rotate>
  <set_rotate>90</set_rotate>
  <video_codec>copy</video_codec>
  <audio_codec>copy</audio_codec>
</format>

The encoder that we choose for this particular encode will automagically change the dimension on your requested encode to the nearest multiple of 16 for both width and height. This is to give you the best possible results for viewing these particular flash files. 

Roku 2700k Template

<format>
  <output>mp4</output>
  <destination>
  <size>1280x720</size>
  <bitrate>2700k</bitrate>
  <audio_bitrate>192k</audio_bitrate>
  <audio_sample_rate>44100</audio_sample_rate>
  <audio_channels_number>2</audio_channels_number>
  <keep_aspect_ratio>yes</keep_aspect_ratio>
  <video_codec>libx264</video_codec>
  <profile>high</profile>
  <VCodecParameters>yes</VCodecParameters>
           <video_codec_parameters>
           <coder>1</coder>
           <flags>+loop</flags>
           <flags2>+wpred+mixed_refs+dct8x8+fastpskip</flags2>
           <partitions>+parti8x8+parti4x4+partp8x8+partb8x8</partitions>
           <me_method>umh</me_method>
           <subq>8</subq>
           <me_range>16</me_range>
           <bf>4</bf>
           <keyint_min>25</keyint_min>
           <sc_threshold>40</sc_threshold>
           <i_qfactor>0.71</i_qfactor>
           <b_strategy>2</b_strategy>
           <qcomp>0.6</qcomp>
           <qmin>10</qmin>
           <qmax>51</qmax>
           <qdiff>4</qdiff>
           <b_qfactor/>
           <directpred>3</directpred>
           <trellis>1</trellis>
           <level>30</level>
           <refs>4</refs>
           <wpredp>0</wpredp>
  </video_codec_parameters>
  <audio_codec>libfaac</audio_codec>
  <two_pass>no</two_pass>
  <turbo>yes</turbo>
  <twin_turbo>no</twin_turbo>
  <cbr>no</cbr>
  <deinterlacing>no</deinterlacing>
  <keyframe>200</keyframe>
  <audio_volume>100</audio_volume>
  <rotate>0</rotate>
  <file_extension>mp4</file_extension>
  <hint>no</hint>
</format>

Roku 1800k Template

<format>
  <output>mp4</output>
  <destination>
  <size>1280x720</size>
  <bitrate>1800k</bitrate>
  <audio_bitrate>128k</audio_bitrate>
  <audio_sample_rate>44100</audio_sample_rate>
  <audio_channels_number>2</audio_channels_number>
  <keep_aspect_ratio>yes</keep_aspect_ratio>
  <video_codec>libx264</video_codec>
  <profile>high</profile>
  <VCodecParameters>yes</VCodecParameters>
           <video_codec_parameters>
           <coder>1</coder>
           <flags>+loop</flags>
           <flags2>+wpred+mixed_refs+dct8x8+fastpskip</flags2>
           <partitions>+parti8x8+parti4x4+partp8x8+partb8x8</partitions>
           <me_method>umh</me_method>
           <subq>8</subq>
           <me_range>16</me_range>
           <bf>4</bf>
           <keyint_min>25</keyint_min>
           <sc_threshold>40</sc_threshold>
           <i_qfactor>0.71</i_qfactor>
           <b_strategy>2</b_strategy>
           <qcomp>0.6</qcomp>
           <qmin>10</qmin>
           <qmax>51</qmax>
           <qdiff>4</qdiff>
           <b_qfactor/>
           <directpred>3</directpred>
           <trellis>1</trellis>
           <level>30</level>
           <refs>4</refs>
           <wpredp>0</wpredp>
  </video_codec_parameters>
  <audio_codec>libfaac</audio_codec>
  <two_pass>no</two_pass>
  <turbo>yes</turbo>
  <twin_turbo>no</twin_turbo>
  <cbr>no</cbr>
  <deinterlacing>no</deinterlacing>
  <keyframe>200</keyframe>
  <audio_volume>100</audio_volume>
  <rotate>0</rotate>
  <file_extension>mp4</file_extension>
  <hint>no</hint>
</format>

Roku 1200k Template

<format>
  <output>mp4</output>
  <destination>
  <size>640x480</size>
  <bitrate>1200k</bitrate>
  <audio_bitrate>192k</audio_bitrate>
  <audio_sample_rate>44100</audio_sample_rate>
  <audio_channels_number>2</audio_channels_number>
  <keep_aspect_ratio>yes</keep_aspect_ratio>
  <video_codec>libx264</video_codec>
  <profile>main</profile>
  <VCodecParameters>yes</VCodecParameters>
           <video_codec_parameters>
           <coder>1</coder>
           <flags>+loop</flags>
           <flags2>+wpred+mixed_refs+dct8x8+fastpskip</flags2>
           <partitions>+parti8x8+parti4x4+partp8x8+partb8x8</partitions>
           <me_method>umh</me_method>
           <subq>8</subq>
           <me_range>16</me_range>
           <bf>4</bf>
           <keyint_min>25</keyint_min>
           <sc_threshold>40</sc_threshold>
           <i_qfactor>0.71</i_qfactor>
           <b_strategy>2</b_strategy>
           <qcomp>0.6</qcomp>
           <qmin>10</qmin>
           <qmax>51</qmax>
           <qdiff>4</qdiff>
           <b_qfactor/>
           <directpred>3</directpred>
           <trellis>1</trellis>
           <level>30</level>
           <refs>4</refs>
           <wpredp>0</wpredp>
  </video_codec_parameters>
  <audio_codec>libfaac</audio_codec>
  <two_pass>no</two_pass>
  <turbo>yes</turbo>
  <twin_turbo>no</twin_turbo>
  <cbr>no</cbr>
  <deinterlacing>no</deinterlacing>
  <keyframe>200</keyframe>
  <audio_volume>100</audio_volume>
  <rotate>0</rotate>
  <file_extension>mp4</file_extension>
  <hint>no</hint>
</format>

Standard Template for 800k

<format>
  <output>mp4</output>
  <destination>
  <size>640x480</size>
  <bitrate>800k</bitrate>
  <audio_bitrate>128k</audio_bitrate>
  <audio_sample_rate>44100</audio_sample_rate>
  <audio_channels_number>2</audio_channels_number>
  <keep_aspect_ratio>yes</keep_aspect_ratio>
  <video_codec>libx264</video_codec>
  <profile>main</profile>
  <VCodecParameters>yes</VCodecParameters>
           <video_codec_parameters>
           <coder>1</coder>
           <flags>+loop</flags>
           <flags2>+wpred+mixed_refs+dct8x8+fastpskip</flags2>
           <partitions>+parti8x8+parti4x4+partp8x8+partb8x8</partitions>
           <me_method>umh</me_method>
           <subq>8</subq>
           <me_range>16</me_range>
           <bf>4</bf>
           <keyint_min>25</keyint_min>
           <sc_threshold>40</sc_threshold>
           <i_qfactor>0.71</i_qfactor>
           <b_strategy>2</b_strategy>
           <qcomp>0.6</qcomp>
           <qmin>10</qmin>
           <qmax>51</qmax>
           <qdiff>4</qdiff>
           <b_qfactor/>
           <directpred>3</directpred>
           <trellis>1</trellis>
           <level>30</level>
           <refs>4</refs>
           <wpredp>0</wpredp>
  </video_codec_parameters>
  <audio_codec>libfaac</audio_codec>
  <two_pass>no</two_pass>
  <turbo>yes</turbo>
  <twin_turbo>no</twin_turbo>
  <cbr>no</cbr>
  <deinterlacing>no</deinterlacing>
  <keyframe>200</keyframe>
  <audio_volume>100</audio_volume>
  <rotate>0</rotate>
  <file_extension>mp4</file_extension>
  <hint>no</hint>
</format>

Use a 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.

Note: the logo_transparent tag is only for usage with the vp6_flix output via XML.

Example XML:

<logo>
  <logo_source>[LogoURL]</logo_source>
  <logo_x>[LogoLeft]</logo_x>
  <logo_y>[LogoTop]</logo_y>
  <logo_mode>1</logo_mode>
  <logo_threshold>[LogoTreshold]</logo_threshold>
  <logo_transparent>[LogoTransparent]</logo_transparent>
</logo>

Thinking of using FTPS as your source locations? No problemo.

All you need to do is specify the port in which we access your file at. Connections via FTPS will use port 22 by default. If you'd like to specify a different port, add it to then end of your URL.

Example:

FTPS://www.xyz.com:[port]/files/input.mov

Thinking of using HTTPS as your source locations? No problemo.

All you need to do is specify the port in which we access your file at. Connections via HTTPS will use port 443 by default. If you'd like to specify a different port, add it to then end of your URL.

Example:

HTTPS://www.xyz.com:[port]/files/input.mov

Save some time with your encodes with this simple step, if you are sourcing from S3, try this URL formatting:

http://[AWS_KEY:AWS_SECRET@][bucket].s3.amazonaws.com/[filename]?nocopy

if 'nocopy' is specified at the end of your URL, the source file will be downloaded directly from your bucket, thus saving time. Please use this only if your buckets are located in the US. If ?nocopy is not specified at the end of your URL, the source will be copied to Encoding.com bucket first. This workflow saves you traffic in the case of non-US buckets and more than one encoding task per source.

Standard Wowza Template

<format>
    <output>wowza</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>128k</audio_bitrate>
    <audio_sample_rate>48000</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <framerate>24</framerate>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>main</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <turbo>no</turbo>
    <twin_turbo>no</twin_turbo>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mov</file_extension>
    <hint>no</hint>
  </format>

Standard Wowza MBR Template

<format>
    <output>wowza_multibitrate</output>
    <audio_bitrate>128k</audio_bitrate>
    <audio_sample_rate>48000</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <framerate>24</framerate>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>main</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <turbo>no</turbo>
    <twin_turbo>no</twin_turbo>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mov</file_extension>
    <hint>no</hint>
    <bitrates>270k,570k,1000k,1200k,1400k</bitrates>
    <sizes>320x180,420x270,720x406,1024x576,1080x608</sizes>
  </format>

Roku HLS (HTTP Live Streaming) Template

<format>
  <output>ipad_stream</output>
  <destination>
  <size>0x480</size>
  <bitrate>1024k</bitrate>
  <audio_bitrate>96k</audio_bitrate>
  <audio_sample_rate>44100</audio_sample_rate>
  <audio_channels_number>2</audio_channels_number>
  <keep_aspect_ratio>yes</keep_aspect_ratio>
  <video_codec>libx264</video_codec>
  <VCodecParameters>yes</VCodecParameters>
           <video_codec_parameters>
           <coder>1</coder>
           <flags>+loop</flags>
           <flags2>+wpred+mixed_refs+dct8x8+fastpskip</flags2>
           <partitions>+parti8x8+parti4x4+partp8x8+partb8x8</partitions>
           <me_method>umh</me_method>
           <subq>8</subq>
           <me_range>16</me_range>
           <bf>4</bf>
           <keyint_min>25</keyint_min>
           <sc_threshold>40</sc_threshold>
           <i_qfactor>0.71</i_qfactor>
           <b_strategy>2</b_strategy>
           <qcomp>0.6</qcomp>
           <qmin>10</qmin>
           <qmax>51</qmax>
           <qdiff>4</qdiff>
           <b_qfactor/>
           <directpred>3</directpred>
           <trellis>1</trellis>
           <level>30</level>
           <refs>4</refs>
           <wpredp>0</wpredp>
  </video_codec_parameters>
  <profile>main</profile>
  <audio_codec>libfaac</audio_codec>
  <two_pass>no</two_pass>
  <turbo>yes</turbo>
  <twin_turbo>no</twin_turbo>
  <cbr>no</cbr>
  <deinterlacing>no</deinterlacing>
  <keyframe>300</keyframe>
  <audio_volume>100</audio_volume>
  <rotate>def</rotate>
  <file_extension>tar</file_extension>
  <hint>no</hint>
  <bitrates>1200k,800k,600k,400k,200k,110k</bitrates>
  <framerates>29.97,29.97,29.97,29.97,15,10</framerates>
  <keyframes>90,90,90,90,45,30</keyframes>
  <pack_files>no</pack_files>
  <segment_duration>10</segment_duration>
  <add_audio_only>no</add_audio_only>
  <still_image></still_image>
  <still_image_time></still_image_time>
</format>

Standard Templates for Blackberry devices. 

Old phones

<format>
   <output>3gp</output>
   <size>176x144</size>
   <bitrate>384k</bitrate>
   <audio_bitrate>12.2k</audio_bitrate>
   <audio_sample_rate>8000</audio_sample_rate>
   <audio_channels_number>1</audio_channels_number>
   <framerate>15</framerate>
   <keep_aspect_ratio>yes</keep_aspect_ratio>
   <video_codec>h263</video_codec>
   <profile>baseline</profile>
   <VCodecParameters>no</VCodecParameters>
   <audio_codec>libamr_nb</audio_codec>
   <two_pass>no</two_pass>
   <turbo>no</turbo>
   <twin_turbo>no</twin_turbo>
   <cbr>no</cbr>
   <deinterlacing>no</deinterlacing>
   <keyframe>90</keyframe>
   <audio_volume>100</audio_volume>
   <file_extension>3gp</file_extension>
</format>

New Phones

<format>
   <output>mp4</output>
   <size>240x180</size>
   <bitrate>240k</bitrate>
   <audio_bitrate>40k</audio_bitrate>
   <audio_sample_rate>22050</audio_sample_rate>
   <audio_channels_number>1</audio_channels_number>
   <framerate>15</framerate>
   <keep_aspect_ratio>yes</keep_aspect_ratio>
   <video_codec>mpeg4</video_codec>
   <profile>main</profile>
   <VCodecParameters>no</VCodecParameters>
   <audio_codec>libmp3lame</audio_codec>
   <two_pass>yes</two_pass>
   <turbo>no</turbo>
   <twin_turbo>no</twin_turbo>
   <cbr>no</cbr>
   <deinterlacing>no</deinterlacing>
   <keyframe>90</keyframe>
   <audio_volume>100</audio_volume>
   <file_extension>mp4</file_extension>
   <hint>no</hint>
</format>

<format>
   <output>mp4</output>
   <size>240x180</size>
   <bitrate>300k</bitrate>
   <audio_bitrate>64k</audio_bitrate>
   <audio_sample_rate>22050</audio_sample_rate>
   <audio_channels_number>1</audio_channels_number>
   <framerate>25</framerate>
   <keep_aspect_ratio>yes</keep_aspect_ratio>
   <video_codec>libx264</video_codec>
   <profile>baseline</profile>
   <VCodecParameters>no</VCodecParameters>
   <audio_codec>libfaac</audio_codec>
   <two_pass>yes</two_pass>
   <turbo>no</turbo>
   <twin_turbo>no</twin_turbo>
   <cbr>no</cbr>
   <deinterlacing>no</deinterlacing>
   <keyframe>150</keyframe>
   <audio_volume>100</audio_volume>
   <file_extension>mp4</file_extension>
   <hint>no</hint>
</format>
</query>

Standard Zune Template

<format>
    <output>zune</output>
    <size>320x180</size>
    <bitrate>512k</bitrate>
    <audio_bitrate>128k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>wmv2</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>wmav2</audio_codec>
    <two_pass>no</two_pass>
    <turbo>no</turbo>
    <twin_turbo>no</twin_turbo>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>wmv</file_extension>
  </format>

Use GetBandwidthStatGroupDate to return encoding traffic of selected user. You can specify a certain date to return information on a particular user. The traffic will be grouped by existing's dates. Please note "date_to" and "date_from" the optional fields. You should use it if you intend to recieve bandwidth statistic into specified date interval. Post the following XML to the API

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>GetBandwidthStatGroupDate</action>
<action_user_id>[ActionUserID]</action_user_id>
<date_from>[YYYY-MM-DD]</date_from>
</date_to>[YYYY-MM-DD]</date_to>
</query>

Response:

<?xml version="1.0"?>
<response>
  <action>getbandwidthstatgroupdate</action>
  <status>Success</status>
  <result>
     <user_id>[userID]</user_id>
     <date_[date1]>
       <in>
         <bytes>[amount in bytes]</bytes>
         <gb>[amount in gigabytes]</gb>
      </in>
       <out>
         <bytes>[amount in bytes]</bytes>
         <gb>[amount in gigabytes]</gb>
      </out>
     </date_[date1]>
     <date_[date2]>
        <in>
          <bytes>[amount in bytes]</bytes>
          <gb>[amount in gigabytes]</gb>
       </in>
       <out>
         <bytes>[amount in bytes]</bytes>
         <gb>[amount in gigabytes]</gb>
      </out>
    </date_[date2]>
...
  </result>
</response>

Use GetBandwidthStat to return encoding traffic of selected user. You can specify a certain date to return information on a particular user. Please note "date_to" and "date_from" the optional fields. You should use it if you intend to recieve bandwidth statistic into specified date interval. Post the following XML to the API:

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>GetBandwidthStat</action>
<action_user_id>[ActionUserID]</action_user_id>
<date_from>[YYYY-MM-DD]</date_from>
</date_to>[YYYY-MM-DD]</date_to>
</query>

and your return will be:

<?xml version="1.0"?>
<response>
   <action>getbandwidthstat</action>
   <status>Success</status>
   <result>
    <user_id>[UserID]</user_id>
    <date_from>[Date from]</date_from>
    <date_to>[Date to]</date_to>
    <in>
       <bytes>[amount in bytes]</bytes>
       <gb>[amount in gigabytes]</gb>
   </in>
   <out>
       <bytes>[amount in bytes]</bytes>
       <gb>[amount in gigabytes]</gb>
   </out>
   <turbo>
       <bytes>[amount in bytes]</bytes>
       <gb>[amount in gigabytes]</gb>
   </turbo>
  </result>
</response>

Interested in a particular user's storage space. Send this XML to our API:

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>GetStorageSpace</action>
<action_user_id>[ActionUserID]</action_user_id>
</query>

The response that you'll receive in is GB as follows:

<?xml version="1.0"?>
<response>
   <action>getstoragespace</action>
   <status>Success</status>
   <result>
     <user_id>[UserID]</user_id>
     <gb>[Storage Space]</gb>
   </result>
</response>

Say you're interested in how a user's been using the platform. In particular, their success rate, queue times, bandwidth specs, etc. Use GetASM to return this info. Here's an example of the XML to send to the API

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>GetASM</action>
<action_user_id>[ActionUserID]</action_user_id>
</query>

and the response:

<?xml version="1.0"?>
<response>
  <action>getasm</action>
  <status>Success</status>
  <result>
    <user_id>[UserID]</user_id>
    <encoding_success_rate>
        <percentage>100</percentage>
    </encoding_success_rate>
    <queue_time>
        <second>[average queue time in this month]</second>
    </queue_time>
    <processing_time>
        <second>[average processing time in this month]</second>
    </processing_time>
    <connection_speed>
        <kbs>[average connection speed]</kbs>
    </connection_speed>
    <encoding_bandwidth>
         <gb>[average amount of encoding bandwidth]</gb>
    </encoding_bandwidth>
  </result>
</response>

Let's say you've made a ton of subusers, but want information back as a whole on all the users you've created. Send the following to the API...

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid>
    <userkey>[UserKey]</userkey>
    <action>getsubusers</action>
</query>

and you'll get in return a complete list of who's who for sub users:

<?xml version="1.0"?>
<response>
  <action>getsubusers</action>
  <status>Success</status>
  <result>
    <user_id></user_id>
    <user_0>
      <ID>[UserID]</ID>
      <Login>[Login]</Login>
      <FirstName>[FirstName]</FirstName>
      <LastName>[LastName]</LastName>
      <Email>[Email]</Email>
      <UserKey>[UserKey]</UserKey>
      <Country>[Country]</Country>
      <Phone>[Phone]</Phone>
      <Status>[Status]</Status>
    </user_0>
    <user_1>
      <ID>[UserID]</ID>
      <Login>[Login]</Login>
      <FirstName>[FirstName]</FirstName>
      <LastName>[LastName]</LastName>
      <Email>[Email]</Email>
      <UserKey>[UserKey]</UserKey>
      <Country>[Country]</Country>
      <Phone>[Phone]</Phone>
      <Status>[Status]</Status>
   </user_1>
  </result>
</response>

For sub accounts, the whole point of creating them is to track usage, right? Well, since we have no UI, you'll want a way to see the information we have stored on a particular user under your main account. Use GetUserInfo to return information on a particular user:

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>GetUserInfo</action>
<action_user_id>[ActionUserID]</action_user_id>
</query>

We'll return back this handy information:

<?xml version="1.0"?>
<response>
  <action>getuserinfo</action>
  <status>Success</status>
  <result>
    <user_id>[ActionUserID]</user_id>
    <ID>[ActionUserID]</ID>
    <Login>[Login]</Login>
    <FirstName>[FirstName]</FirstName>
    <LastName>[LastName]</LastName>
    <Email>[Email]</Email>
    <UserKey>[UserKey]</UserKey>
    <Country>[Country]</Country>
    <Phone>[Phone]</Phone>
    <Status>[Status]</Status>
  </result>
</response>

If you wish to update the email address and phone number of a sub user, send the following format of XML to our API.

<?xml version="1.0"?>
<query>
<!-- Main fields -->
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>UpdateSubUser</action>
<action_user_id>[ActionUserID]</action_user_id>
<user_data>
<email>[New email]</email>
<phone>[New phone]</phone>
</user_data>
</query>

You'll receive the following back to confirm success of the update:

<?xml version="1.0"?>
<response>
  <action>updatesubuser</action>
  <status>Success</status>
  <result>
    <user_id></user_id>
    <message>The user data was updated</message>
    <email>[New Email]</email>
    <country>[New Country]</country>
  </result>
</response>

You can easily delete sub accounts from your master account by sending the following XML to the API:

<?xml version="1.0"?>
<query>
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>DeleteSubUser</action>
<action_user_id>[ActionUserID]</action_user_id>
</query>

You'll receive the following response:

<?xml version="1.0"?>
<response>
<action>deletesubuser</action>
<status>Success</status>
</response>

To sign up a sub user on your account, you'll need to provide Encoding.com with a few pieces of information on the sub user. 

<?xml version="1.0"?>
<query>
<!-- Main fields -->
<userid>[UserID]</userid>
<userkey>[UserKey]</userkey>
<action>AddSubUser</action>
<user_data>
<email>[Email]</email>
<login>[Login]</login>
<password>[Password]</password>
<first_name>[FirstName]</first_name>
<last_name>[LastName]</last_name>
<phone>[Phone]</phone>
</user_data>
</query>

You'll receive the following response back from the system once the user has been created:

<?xml version="1.0"?>
<response>
<action>addsubuser</action>
<status>Success</status>
<result>
<plan>Max</plan>
<user_id>New_UserID</user_id>
<user_key>Unique_subaccount_API_key</user_key>
<message>The new sub user has been created</message>
</result>
</response>

Sub accounts are only granted to users on MAX or higher accounts. They are a useful way of tracking bandwidth on the master account if you have many users / agencies on your account. Please note that there is no UI for sub users, as its entirely supported by the API. Contact the administrator of the plan that signed up with Encoding.com for more information. This feature is not automatically turned on by Encoding.com; you must request this by contacting the Help Desk. For full information on sub accounts, please check out the complete API documentation.

http://www.encoding.com/api/category/category/sub_account_api_documentation

Encoding.com does not use FTP passive mode by default when retrieving or placing files. To use FTP with passive mode turned on, add ?passive=yes to the end of your FTP URL string (either source or destination): ftp://user:pass@ftphost.tld/path/to/your/file.ext?passive=yes

So you're hunting for the field in the web UI or our API as to designate hinting on 3GP files? Easy answer, our encoders prep all 3GP files for streaming, no need to do anything else to your settings files.

If you're interested in using Encoding.com's platform to create iPhone Streaming (m3u8) files from your source content, there's a number of ways to achieve that using the options listed below. Our new HLS encoding has better adaptive bitrate distribution within the H.264 segments!

<format>
    <output>iphone_stream</output>
    <destination>ftp://***** the output iphone index file (.m3u8) *****</destination>
    <size>400x300</size>
    <audio_bitrate>56k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>iphone_stream</profile>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <turbo>yes</turbo>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <rotate>0</rotate>
    <file_extension>tar</file_extension>
    <hint>no</hint>
    <bitrates>600k,400k,200k,110k</bitrates>
    <framerates>29.97,29.97,15,10</framerates>
    <keyframes>90,90,45,30</keyframes>
    <pack_files>no</pack_files>
    <segment_duration>10</segment_duration>
    <add_audio_only>yes</add_audio_only>
    <still_image>first_segment</still_image>
    <still_image_time>5</still_image_time>
    <still_image_size>480x320</still_image_size>
  </format>

Set to 'yes' to initiate the encoding process immediately when source video begins downloading to our processing center as opposed to waiting until after the download has completed. Also, this feature can be used when source media is still uploading to the specified source FTP location - our system will recognize if the source file size increases while downloading, or soon after, and the "tail" will be downloaded and concatenated.

Our MPEG-2 encoder offers advanced encoding parameters for both GOP structure and cadence. Closed GOPs with scene detection are ideal for delivery to many STBs (Set-Top-Boxes), such as Tivo and Roku. The Strict GOPs option locks the size to your keyframe value, and is necessary for some hardware DRM solutions. We also now provide MPEG-2 keyframe presets for both DVD and Long-GOP output, as well as the option to turn B-frames on/off. This greatly increases compatibility with a wide range of MPEG-2 players and chipsets.

MPEG-2 API options

Here are all the accepted values for our API

<output>mpeg2</output>  
<keyframe>[12|15|25|30]</keyframe><!--GOP length for NTSC/PAL-->
<bframes>[2|0]</bframes><!--bidirectional frames-->
<gop>[cgop|sgop]</gop><!--closed or strict GOP-->   
</output>

MPEG-2 Advanced XML Samples

Sample for Tivo and NTSC DVD output

Closed 15-frame GOP using standard IPBBPBBP cadence.

<output>mpeg2</output>  
<keyframe>15</keyframe>   
<bframes>2</bframes>  
<gop>cgop</gop>   
</output>

Sample for PAL DVD output

Closed 12-frame GOP using standard IPBBPBBP cadence.

<output>mpeg2</output>  
<keyframe>12</keyframe>   
<bframes>2</bframes>  
<gop>cgop</gop>   
</output>

Sample for Cablelabs Broadcast NTSC output

Long 30-frame GOP using broadcast IPPPPPPP cadence.

<output>mpeg2</output>  
<keyframe>30</keyframe>   
<bframes>0</bframes>  
<gop>cgop</gop>   
</output>

Standard Flash 9 Template

<format>
    <output>fl9</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>high</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
  </format>

Standard Template for MPEG2

<format>
    <output>mpeg2</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>256k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg2video</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>mp2</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>15</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mpg</file_extension>
    <bframes>2</bframes>
    <gop>cgop</gop>
</format>

Standard AAC Audio Template

<format>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <audio_codec>libfaac</audio_codec>
    <audio_volume>100</audio_volume>
    <output>m4a</output>
    <file_extension>m4a</file_extension>
</format>

Standard Windows Media Audio Template

<format>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <audio_codec>wmav2</audio_codec>
    <audio_volume>100</audio_volume>
    <output>wma</output>
    <file_extension>wma</file_extension>
</format>

Standard MP3 Audio Template

<format> 
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <audio_codec>libmp3lame</audio_codec>
    <audio_volume>100</audio_volume>
    <output>mp3</output>
    <file_extension>mp3</file_extension>
</format>

Standard Image2Image Template

<format>
    <output>image</output>
    <image_format>jpg</image_format>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <resize_method>resize</resize_method>
    <quality>80</quality>
    <sharpen_sigma>0.5</sharpen_sigma>
</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>

Standard Template for WebM

<format>
    <output>webm</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libvpx</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libvorbis</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <preset>6</preset>
    <file_extension>webm</file_extension>
    <acbr>no</acbr>
</format>

Standard template for 3GP

 <format>
    <output>3gp</output>
    <size>176x144</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>12.2k</audio_bitrate>
    <audio_sample_rate>8000</audio_sample_rate>
    <audio_channels_number>1</audio_channels_number>
    <framerate>15</framerate>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>h263</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libamr_nb</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>3gp</file_extension>
</format>

Standard Flash 8 VP6 Flix Engine Template

<format>
    <output>vp6_flix</output>
    <file_extension>flv</file_extension>
    <video_codec>vp6_flix</video_codec>
    <size>320x240</size>
    <bitrate>200k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <vp6_profile>1</vp6_profile>
    <keyframe>300</keyframe>
    <upct>90</upct>
    <kfinttype>1</kfinttype>
    <cxmode>1</cxmode>
</format>

Standard Flash 8 VP6 Template

<format>
    <output>vp6</output>
    <file_extension>flv</file_extension>
    <video_codec>vp6</video_codec>
    <size>320x240</size>
    <bitrate>200k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
</format>

Standard Template for muxed output

<format>
    <output>muxer</output>
    <file_extension>vcd</file_extension>
    <video_codec>muxer</video_codec>
    <target>ntsc-dvd</target>
    <size>320x240</size>
    <maps>0:0,1:0</maps>
</format>

Standard PSP Template

<format>
    <output>psp</output>
    <size>368x192</size>
    <bitrate>1024k</bitrate>
    <audio_bitrate>128k</audio_bitrate>
    <audio_sample_rate>24000</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <framerate>30000/1001</framerate>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
 </format>

Standard Template for Apple TV

<format>
    <output>appletv</output>
    <size>710x480</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
</format>

Standard Ogg Video Template

<format>
    <output>ogg</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libtheora</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libvorbis</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>ogg</file_extension>
    <acbr>no</acbr>
 </format>

Standard iPad Streaming Template

<format>
    <output>ipad_stream</output>
    <size>640x480</size>
    <audio_bitrate>40k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>main</profile>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <audio_volume>100</audio_volume>
    <file_extension>tar</file_extension>
    <hint>no</hint>
    <bitrates>1200k,800k,600k,400k,200k,110k</bitrates>
    <framerates>29.97,29.97,29.97,29.97,15,10</framerates>
    <keyframes>90,90,90,90,45,30</keyframes>
    <pack_files>yes</pack_files>
    <segment_duration>10</segment_duration>
    <add_audio_only>no</add_audio_only>
    <still_image>no</still_image>
    <still_image_time>5</still_image_time>
    <still_image_size>480x320</still_image_size>
 </format>

<format>
    <output>iphone_stream</output>
    <size>400x300</size>
    <audio_bitrate>40k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>iphone_stream</profile>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <audio_volume>100</audio_volume>
    <file_extension>tar</file_extension>
    <hint>no</hint>
    <bitrates>600k,400k,200k,110k</bitrates>
    <framerates>29.97,29.97,15,10</framerates>
    <keyframes>90,90,45,30</keyframes>
    <pack_files>yes</pack_files>
    <segment_duration>10</segment_duration>
    <add_audio_only>no</add_audio_only>
    <still_image>no</still_image>
    <still_image_time>5</still_image_time>
    <still_image_size>480x320</still_image_size>
</format>

Standard iPad Template

<format>
    <output>ipad</output>
    <size>640x480</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>40k</audio_bitrate>
    <audio_sample_rate>22050</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
</format>

Standard template for iPhone video

<format>
    <output>iphone</output>
    <size>480x368</size>
    <bitrate>1024k</bitrate>
    <audio_bitrate>128k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
 </format>

Standard iPod template

<format>
    <output>ipod</output>
    <size>320x240</size>
    <bitrate>1024k</bitrate>
    <audio_bitrate>128k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>libx264</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
</format>

Raw MPEG4 Template

<format>
    <output>m4v</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>main</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>m4v</file_extension>
  </format>

Standard QuickTime MOV template

<format>
    <output>mov</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>main</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mov</file_extension>
    <hint>no</hint>
</format>

Standard template for MPEG4

<format>
    <output>mp4</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>main</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libfaac</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>mp4</file_extension>
    <hint>no</hint>
  </format>

Standard template for WMV:

<format>
    <output>wmv</output>
    <size>320x240</size>
    <bitrate>256k</bitrate>
    <audio_bitrate>64k</audio_bitrate>
    <audio_sample_rate>44100</audio_sample_rate>
    <audio_channels_number>2</audio_channels_number>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>wmv2</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>wmav2</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>wmv</file_extension>
</format>

Standard template for Android preset:

<format>
    <output>android</output>
    <size>800x480</size>
    <bitrate>1024k</bitrate>
    <audio_bitrate>12.2k</audio_bitrate>
    <audio_sample_rate>8000</audio_sample_rate>
    <audio_channels_number>1</audio_channels_number>
    <framerate>30</framerate>
    <keep_aspect_ratio>yes</keep_aspect_ratio>
    <video_codec>mpeg4</video_codec>
    <profile>baseline</profile>
    <VCodecParameters>no</VCodecParameters>
    <audio_codec>libamr_nb</audio_codec>
    <two_pass>no</two_pass>
    <cbr>no</cbr>
    <deinterlacing>no</deinterlacing>
    <keyframe>300</keyframe>
    <audio_volume>100</audio_volume>
    <file_extension>3gp</file_extension>
</format>

We now have an mpeg-2 muxing feature that takes two source files and outputs a DVD format mpeg-2 file (PAL or NTSC)

Here's a snippet of the XML you would use:

	<?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>  <!---or pal-dvd---!>

	<maps>0:0,1:0</maps> 

	</format> 

	</query>   

Unfortunately, we do not currently support muxing to mpeg-4 output. We also do not support start/duration flags for multiple sources during a concatenation encode, and have no plans to do so.

Encoding.com's watermarking feature does not yet support semi-transparent masks, alpha-channels and a few other potential image features. The watermarking process is based on plain colors, meaning, all pixels should be at 100% opacity and use black (HTML color code: #000000) to produce optimal results. Please also refer to the logo placement help guide for further reading on how to get the service working for watermarking:

http://encoding.com/help/article/how_to_place_a_logo_watermark_in_your_movie/

This feature allows you to combine several video files to one file.

 You can use it via User Interface, or via API.

 User Interface

 To use this feature via user interface, you have to add several video sources in "Add Media" section. And they would automatically combined to one file (in sequential order) during the encoding process.

 API

 To combine several video sources to one file, you should use several <source> elements in your XML request.

 For example:

<?xml version="1.0"?>
<query>
<!-- Main fields -->
    <userid>[UserID]</userid><br>
    <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>
    <format>
      [FormatFields]
    </format>
</query>