Beamr CABR Encoding

Encoding.com has integrated Content-Adaptive Bitrate (CABR) encoding technology from industry leader Beamr to stream video with the highest possible picture quality and up to 50% fewer bits, resulting in smaller file sizes, more satisfied viewers, and lower CDN and storage expenditures. Here's how to enable CABR in your job requests:

🚧

Note

Beamr CABR outputs can be tested at no additional cost with a watermark. An additional per GB and license fee apply to enable Beamr CABR encoding for production workflows.

<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>addMedia</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <video_codec>beamr4avc</video_codec>
        <bitrate>[BitRate]</bitrate>
        <maxrate>[MaxBitRate]</maxrate>
        <keyframe>[GOPSize]</keyframe>
        <profile>[Profile]</profile>
        <cabr>[yes|no]</cabr>
        <two_pass>[yes|no]</two_pass>
        <cbr>[yes|no]</cbr>
        <hard_cbr>[yes|no]</hard_cbr>
        <video_codec_parameters>
            <csq_factor>[CSQFactor]</csq_factor>
            <scene_detect>[SceneDetect]</scene_detect>
            <level>[Level]</level>
        </video_codec_parameters>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "video_codec": "beamr4avc",
            "bitrate": "[BitRate]",
            "maxrate": "[MaxBitRate]",
            "keyframe": "[GOPSize]",
            "profile": "[Profile]",
            "cabr": "[yes|no]",
            "two_pass": "[yes|no]",
            "cbr": "[yes|no]",
            "hard_cbr": "[yes|no]",
            "video_codec_parameters": {
                "csq_factor": "[CSQFactor]",
                "scene_detect": "[SceneDetect]",
                "level": "[Level]"
            },
            // format params
        }
    }
}
<?xml version="1.0"?>
<query>
    <userid><<id>></userid> <!-- required -->
    <userkey><<key>></userkey> <!-- required -->
    <action>addMedia</action> <!-- required-->
    <source>[SourceFile]</source> <!-- required-->
    <format> <!-- required -->
        <output>[output]</output> <!-- required -->
        <video_codec>beamr5hevc</video_codec>
        <bitrate>[BitRate]</bitrate>
        <maxrate>[MaxBitRate]</maxrate>
        <keyframe>[GOPSize]</keyframe>
        <cabr>[yes|no]</cabr>
        <two_pass>[yes|no]</two_pass>
        <cbr>[yes|no]</cbr>
        <hard_cbr>[yes|no]</hard_cbr>
        <video_codec_parameters>
            <csq_factor>[CSQFactor]</csq_factor>
        </video_codec_parameters>
        <!-- format params -->
    </format>
</query>
{
    "query": {
        "userid": "<<id>>", // required
        "userkey": "<<key>>", // required
        "action": "addMedia", // required
        "source": "[SourceFile]", // required
        "format": { // required
            "output": "[output]", // required
            "video_codec": "beamr5hevc",
            "bitrate": "[BitRate]",
            "maxrate": "[MaxBitRate]",
            "keyframe": "[GOPSize]",
            "cabr": "[yes|no]",
            "two_pass": "[yes|no]",
            "cbr": "[yes|no]",
            "hard_cbr": "[yes|no]",
            "video_codec_parameters": {
                "csq_factor": "[CSQFactor]"
            },
            // format params
        }
    }
}

Format Params

Parameter

Description

Allowed Values

Default Value

video_codec

Video codec

beamr4avc, beamr5hevc

none

bitrate

Video bitrate

Nk (where N is any non-zero integer)

none

maxrate

Maximum allowed video bitrate.

N or Nk — where N is any non-zero integer

none

keyframe

Number of frames between keyframes

Positive integer number

60

profile

H264 profile

baseline, main, high

none

cabr

Enable content adaptive bitrate control mode

yes, no

no

two_pass

Two pass decoding

yes, no

no

cbr

Specifies whether to use CBR (Constant bitrate).

yes, no

no

hard_cbr

Specifies whether to use CBR (Constant bitrate) with filler.

yes, no

no

Video Codec Params

Parameter

Description

Allowed Values

Default Value

csq_factor

Enable CSQ mode with specified factor

Integer number between 0 and 51.
0 – disable CSQ mode

none

scene_detect

Scene change detection threshold

Integer number between 0 and 100.

none

level

H264 level

Integer number, for exammple:
0 – auto
10 – level 1
9 – level 1b
11 – level 1.1
12 – level 1.2
41 – level 4.1
etc.

41