04 June 2020

🚧

Note

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

Beamr CABR Encoding

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 customers, and lower CDN and storage expenditures.

<?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": "beamr4avc",
            "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

ParameterDescriptionAllowed ValuesDefault Value
video_codecVideo codecbeamr4avc, beamr5hevcnone
bitrateVideo bitrateNk (where N is any non-zero integer)none
maxrateMaximum allowed video bitrate.N or Nk — where N is any non-zero integernone
keyframeNumber of frames between keyframesPositive integer number60
profileH264 profilebaseline, main, highnone
cabrEnable content adaptive bitrate control modeyes, nono
two_passTwo pass decodingyes, nono
cbrSpecifies whether to use CBR (Constant bitrate).yes, nono
hard_cbrSpecifies whether to use CBR (Constant bitrate) with filler.yes, nono

Video Codec Params

ParameterDescriptionAllowed ValuesDefault Value
csq_factorEnable CSQ mode with specified factorInteger number between 0 and 51.
0 – disable CSQ mode
none
scene_detectScene change detection thresholdInteger number between 0 and 100.none
levelH264 levelInteger 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