AV1 libsvtav1

<?xml version="1.0"?>
<query>
    <userid>[UserID]</userid> {/* required */}
    <userkey>[UserKey]</userkey> {/* required */}
    <action>[Action]</action> {/* required */}
    <source>[SourceFile]</source> {/* required */}
    <format>
        <output>[OutputFormat]</output> {/* required */}
        <video_codec>libsvtav1</video_codec> {/* required */}
        <video_codec_parameters>
            <profile>[Profile]</profile>
            <level>[Level]</level>
            <rc>[RateControl]</rc>
            <qp>[Quantizer]</qp>
            <crf>[CRF]</crf>
            <tbr>[TargetBitrate]</tbr>
            <mbr>[MaxBitrate]</mbr>
            <min-qp>[MinQuantizer]</min-qp>
            <max-qp>[MaxQuantizer]</max-qp>
            <aq-mode>[AdaptiveQuantization]</aq-mode>
            <undershoot-pct>[UndershootPercent]</undershoot-pct>
            <overshoot-pct>[OvershootPercent]</overshoot-pct>
            <mbr-overshoot-pct>[MbrOvershootPercent]</mbr-overshoot-pct>
            <gop-constraint-rc>[GopConstraint]</gop-constraint-rc>
            <buf-sz>[BufferSize]</buf-sz>
            <buf-initial-sz>[BufferInitialSize]</buf-initial-sz>
            <buf-optimal-sz>[BufferOptimalSize]</buf-optimal-sz>
            <minsection-pct>[MinSectionPercent]</minsection-pct>
            <maxsection-pct>[MaxSectionPercent]</maxsection-pct>
            <enable-qm>[EnableQM]</enable-qm>
            <qm-min>[QmMin]</qm-min>
            <qm-max>[QmMax]</qm-max>
            <chroma-qm-min>[ChromaQmMin]</chroma-qm-min>
            <chroma-qm-max>[ChromaQmMax]</chroma-qm-max>
            <lambda-scale-factors>[LambdaScaleFactors]</lambda-scale-factors>
            <tf-strength>[TfStrength]</tf-strength>
            <luminance-qp-bias>[LuminanceQpBias]</luminance-qp-bias>
            <sharpness>[Sharpness]</sharpness>
            <preset>[Preset]</preset>
            <keyint>[Keyint]</keyint>
            <irefresh-type>[IrefreshType]</irefresh-type>
            <scd>[SceneChangeDetection]</scd>
            <lookahead>[Lookahead]</lookahead>
            <hierarchical-levels>[HierarchicalLevels]</hierarchical-levels>
            <pred-struct>[PredStruct]</pred-struct>
            <rtc>[RTC]</rtc>
            <tile-rows>[TileRows]</tile-rows>
            <tile-columns>[TileColumns]</tile-columns>
            <enable-dlf>[EnableDLF]</enable-dlf>
            <enable-cdef>[EnableCDEF]</enable-cdef>
            <enable-restoration>[EnableRestoration]</enable-restoration>
            <enable-tpl-la>[EnableTplLa]</enable-tpl-la>
            <enable-mfmv>[EnableMFMV]</enable-mfmv>
            <enable-dg>[EnableDG]</enable-dg>
            <fast-decode>[FastDecode]</fast-decode>
            <enable-tf>[EnableTF]</enable-tf>
            <enable-overlays>[EnableOverlays]</enable-overlays>
            <tune>[Tune]</tune>
            <scm>[ScreenContentMode]</scm>
            <film-grain>[FilmGrain]</film-grain>
            <film-grain-denoise>[FilmGrainDenoise]</film-grain-denoise>
            <superres-mode>[SuperresMode]</superres-mode>
            <superres-denom>[SuperresDenom]</superres-denom>
            <superres-kf-denom>[SuperresKfDenom]</superres-kf-denom>
            <superres-qthres>[SuperresQthres]</superres-qthres>
            <superres-kf-qthres>[SuperresKfQthres]</superres-kf-qthres>
            <sframe-dist>[SframeDist]</sframe-dist>
            <sframe-mode>[SframeMode]</sframe-mode>
            <color-primaries>[ColorPrimaries]</color-primaries>
            <transfer-characteristics>[TransferCharacteristics]</transfer-characteristics>
            <matrix-coefficients>[MatrixCoefficients]</matrix-coefficients>
            <color-range>[ColorRange]</color-range>
            <chroma-sample-position>[ChromaSamplePosition]</chroma-sample-position>
            <enable-variance-boost>[EnableVarianceBoost]</enable-variance-boost>
            <variance-boost-strength>[VarianceBoostStrength]</variance-boost-strength>
            <variance-octile>[VarianceOctile]</variance-octile>
        </video_codec_parameters>
    </format>
</query>
{
  "query": {
    "userid": "[UserID]",
    "userkey": "[UserKey]",
    "action": "[Action]",
    "source": "[SourceFile]",
    "format": {
      "output": "[OutputFormat]",
      "video_codec": "libsvtav1",
      "video_codec_parameters": {
        "profile": "[Profile]",
        "level": "[Level]",
        "rc": "[RateControl]",
        "qp": "[Quantizer]",
        "crf": "[CRF]",
        "tbr": "[TargetBitrate]",
        "mbr": "[MaxBitrate]",
        "min-qp": "[MinQuantizer]",
        "max-qp": "[MaxQuantizer]",
        "aq-mode": "[AdaptiveQuantization]",
        "undershoot-pct": "[UndershootPercent]",
        "overshoot-pct": "[OvershootPercent]",
        "mbr-overshoot-pct": "[MbrOvershootPercent]",
        "gop-constraint-rc": "[GopConstraint]",
        "buf-sz": "[BufferSize]",
        "buf-initial-sz": "[BufferInitialSize]",
        "buf-optimal-sz": "[BufferOptimalSize]",
        "minsection-pct": "[MinSectionPercent]",
        "maxsection-pct": "[MaxSectionPercent]",
        "enable-qm": "[EnableQM]",
        "qm-min": "[QmMin]",
        "qm-max": "[QmMax]",
        "chroma-qm-min": "[ChromaQmMin]",
        "chroma-qm-max": "[ChromaQmMax]",
        "lambda-scale-factors": "[LambdaScaleFactors]",
        "tf-strength": "[TfStrength]",
        "luminance-qp-bias": "[LuminanceQpBias]",
        "sharpness": "[Sharpness]",
        "preset": "[Preset]",
        "keyint": "[Keyint]",
        "irefresh-type": "[IrefreshType]",
        "scd": "[SceneChangeDetection]",
        "lookahead": "[Lookahead]",
        "hierarchical-levels": "[HierarchicalLevels]",
        "pred-struct": "[PredStruct]",
        "rtc": "[RTC]",
        "tile-rows": "[TileRows]",
        "tile-columns": "[TileColumns]",
        "enable-dlf": "[EnableDLF]",
        "enable-cdef": "[EnableCDEF]",
        "enable-restoration": "[EnableRestoration]",
        "enable-tpl-la": "[EnableTplLa]",
        "enable-mfmv": "[EnableMFMV]",
        "enable-dg": "[EnableDG]",
        "fast-decode": "[FastDecode]",
        "enable-tf": "[EnableTF]",
        "enable-overlays": "[EnableOverlays]",
        "tune": "[Tune]",
        "scm": "[ScreenContentMode]",
        "film-grain": "[FilmGrain]",
        "film-grain-denoise": "[FilmGrainDenoise]",
        "superres-mode": "[SuperresMode]",
        "superres-denom": "[SuperresDenom]",
        "superres-kf-denom": "[SuperresKfDenom]",
        "superres-qthres": "[SuperresQthres]",
        "superres-kf-qthres": "[SuperresKfQthres]",
        "sframe-dist": "[SframeDist]",
        "sframe-mode": "[SframeMode]",
        "color-primaries": "[ColorPrimaries]",
        "transfer-characteristics": "[TransferCharacteristics]",
        "matrix-coefficients": "[MatrixCoefficients]",
        "color-range": "[ColorRange]",
        "chroma-sample-position": "[ChromaSamplePosition]",
        "enable-variance-boost": "[EnableVarianceBoost]",
        "variance-boost-strength": "[VarianceBoostStrength]",
        "variance-octile": "[VarianceOctile]"
      }
    }
  }
}

Profile and Level Parameters

ParameterDescriptionAllowed ValuesDefault Value
profileBitstream profile0 – main
1 – high
2 – professional
none
levelBitstream level, defined in A.3 of the AV1 specDecimal number (e.g., 2.0, 4.0, 5.1, 7.3)none

Rate Control Parameters

ParameterDescriptionAllowed ValuesDefault Value
rcRate control mode0 – CRF or CQP
1 – VBR
2 – CBR
none
qpInitial QP level value (CQP mode only)Integer between 1 and 63none
crfConstant Rate Factor value (CRF mode)Integer between 1 and 70none
tbrTarget Bitrate for VBR and CBR encodingInteger 1-100000 (kbps), supports b/k/m suffixesnone
mbrMaximum Bitrate for Capped CRFInteger 1-100000 (kbps), supports b/k/m suffixesnone
min-qpMinimum quantizer for VBR and CBRInteger between 1 and 63none
max-qpMaximum quantizer for VBR and CBRInteger between 1 and 63none
aq-modeAdaptive QP level0 – off
1 – variance base using AV1 segments
2 – deltaq pred efficiency
none
undershoot-pctAllowable datarate undershoot percentage (VBR/CBR)Integer 0-100none
overshoot-pctAllowable datarate overshoot percentage (VBR/CBR)Integer 0-100none
mbr-overshoot-pctAllowable datarate overshoot percentage for Capped CRFInteger 0-100none
gop-constraint-rcEnable GoP constraint rate control0 – off
1 – on
none
buf-szClient buffer size in ms (CBR only)Integer 20-10000none
buf-initial-szClient initial buffer size in ms (CBR only)Integer 20-10000none
buf-optimal-szClient optimal buffer size in ms (CBR only)Integer 20-10000none
minsection-pctGOP min bitrate (percentage of target rate)Integer 0-100none
maxsection-pctGOP max bitrate (percentage of target rate)Integer 0-10000none

Quantization Matrix Parameters

ParameterDescriptionAllowed ValuesDefault Value
enable-qmEnable quantisation matrices0 – off
1 – on
none
qm-minMin quant matrix flatnessInteger 0-15none
qm-maxMax quant matrix flatnessInteger 0-15none
chroma-qm-minMin chroma quant matrix flatnessInteger 0-15none
chroma-qm-maxMax chroma quant matrix flatnessInteger 0-15none
lambda-scale-factorsScale factors for lambda values per frame type (comma-separated)Comma-separated integers (value/128 = actual scale)none

Psychovisual (PSY) Parameters

ParameterDescriptionAllowed ValuesDefault Value
tf-strengthTemporal filtering strengthInteger 0-4none
luminance-qp-biasAdjusts frame QP based on average lumaInteger 0-100none
sharpnessBias towards decreased/increased sharpnessInteger -7 to 7none

GOP and Temporal Structure Parameters

ParameterDescriptionAllowed ValuesDefault Value
presetEncoder preset (higher = faster, lower quality)Integer -1 to 13none
keyintGOP size in framesInteger >= -2 (-2: ~5 seconds, -1: infinite for CRF)none
irefresh-typeIntra refresh type1 – FWD Frame (Open GOP)
2 – KEY Frame (Closed GOP)
none
scdScene change detection control0 – off
1 – on
none
lookaheadNumber of frames to look aheadInteger -1 to 120 (-1: auto)none
hierarchical-levelsHierarchical levels beyond base layer2 – 3 temporal layers
3 – 4 temporal layers
4 – 5 temporal layers
5 – 6 temporal layers
none
pred-structPrediction structure1 – low delay frames
2 – random access
none
rtcFast settings for RTC in low-delay mode0 – off
1 – on
none

Tiling Parameters

ParameterDescriptionAllowed ValuesDefault Value
tile-rowsNumber of tile rows (log2)Integer 0-6none
tile-columnsNumber of tile columns (log2)Integer 0-4none

AV1 Coding Tools Parameters

ParameterDescriptionAllowed ValuesDefault Value
enable-dlfDeblocking loop filter control0 – off
1 – on
none
enable-cdefEnable Constrained Directional Enhancement Filter0 – off
1 – on
none
enable-restorationEnable loop restoration filter0 – off
1 – on
none
enable-tpl-laTemporal Dependency model control (CRF/CQP only)0 – off
1 – on
none
enable-mfmvMotion Field Motion Vector control-1 – auto
0 – off
1 – on
none
enable-dgDynamic GoP control0 – off
1 – on
none
fast-decodeFast Decoder levels0, 1, or 2none
enable-tfEnable ALT-REF (temporally filtered) frames0 – off
1 – on
2 – on
none
enable-overlaysEnable insertion of overlayer pictures0 – off
1 – on
none

Tuning and Content Parameters

ParameterDescriptionAllowed ValuesDefault Value
tuneTuning metric0 – VQ
1 – PSNR
2 – SSIM
none
scmScreen content detection level0 – off
1 – on
2 – content adaptive
none
film-grainFilm grain level (denoising level)Integer 0-50none
film-grain-denoiseApply denoising when film grain is ON0 – no denoising
1 – level set by film-grain parameter
none

Super-Resolution Parameters

ParameterDescriptionAllowed ValuesDefault Value
superres-modeSuper-resolution mode0 – off
1, 2, 3 – on
4 – auto-select
none
superres-denomSuper-resolution denominator (mode 1 only)Integer 8-16 (8: no scaling, 16: half-scaling)none
superres-kf-denomSuper-resolution denominator for key frames (mode 1 only)Integer 8-16none
superres-qthresSuper-resolution q-threshold (mode 3 only)Integer 0-63none
superres-kf-qthresSuper-resolution q-threshold for key frames (mode 3 only)Integer 0-63none

S-Frame Parameters

ParameterDescriptionAllowed ValuesDefault Value
sframe-distS-Frame interval in framesInteger >= 0 (0: off)none
sframe-modeS-Frame insertion mode1 – only if altref frame
2 – next altref frame
none

Color Metadata Parameters

ParameterDescriptionAllowed ValuesDefault Value
color-primariesColor primariesInteger 0-22none
transfer-characteristicsTransfer characteristicsInteger 0-22none
matrix-coefficientsMatrix coefficientsInteger 0-14none
color-rangeColor range0 – Studio
1 – Full
none
chroma-sample-positionChroma sample positionunknown, vertical, left, colocated, topleftnone

Variance Boost Parameters

ParameterDescriptionAllowed ValuesDefault Value
enable-variance-boostEnable variance boost0 – off
1 – on
none
variance-boost-strengthVariance boost strengthInteger 1-4none
variance-octileOctile for variance boostInteger 1-8none