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

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

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.