<?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
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| profile | Bitstream profile | 0 – main 1 – high 2 – professional | none |
| level | Bitstream level, defined in A.3 of the AV1 spec | Decimal number (e.g., 2.0, 4.0, 5.1, 7.3) | none |
Rate Control Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| rc | Rate control mode | 0 – CRF or CQP 1 – VBR 2 – CBR | none |
| qp | Initial QP level value (CQP mode only) | Integer between 1 and 63 | none |
| crf | Constant Rate Factor value (CRF mode) | Integer between 1 and 70 | none |
| tbr | Target Bitrate for VBR and CBR encoding | Integer 1-100000 (kbps), supports b/k/m suffixes | none |
| mbr | Maximum Bitrate for Capped CRF | Integer 1-100000 (kbps), supports b/k/m suffixes | none |
| min-qp | Minimum quantizer for VBR and CBR | Integer between 1 and 63 | none |
| max-qp | Maximum quantizer for VBR and CBR | Integer between 1 and 63 | none |
| aq-mode | Adaptive QP level | 0 – off 1 – variance base using AV1 segments 2 – deltaq pred efficiency | none |
| undershoot-pct | Allowable datarate undershoot percentage (VBR/CBR) | Integer 0-100 | none |
| overshoot-pct | Allowable datarate overshoot percentage (VBR/CBR) | Integer 0-100 | none |
| mbr-overshoot-pct | Allowable datarate overshoot percentage for Capped CRF | Integer 0-100 | none |
| gop-constraint-rc | Enable GoP constraint rate control | 0 – off 1 – on | none |
| buf-sz | Client buffer size in ms (CBR only) | Integer 20-10000 | none |
| buf-initial-sz | Client initial buffer size in ms (CBR only) | Integer 20-10000 | none |
| buf-optimal-sz | Client optimal buffer size in ms (CBR only) | Integer 20-10000 | none |
| minsection-pct | GOP min bitrate (percentage of target rate) | Integer 0-100 | none |
| maxsection-pct | GOP max bitrate (percentage of target rate) | Integer 0-10000 | none |
Quantization Matrix Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| enable-qm | Enable quantisation matrices | 0 – off 1 – on | none |
| qm-min | Min quant matrix flatness | Integer 0-15 | none |
| qm-max | Max quant matrix flatness | Integer 0-15 | none |
| chroma-qm-min | Min chroma quant matrix flatness | Integer 0-15 | none |
| chroma-qm-max | Max chroma quant matrix flatness | Integer 0-15 | none |
| lambda-scale-factors | Scale factors for lambda values per frame type (comma-separated) | Comma-separated integers (value/128 = actual scale) | none |
Psychovisual (PSY) Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| tf-strength | Temporal filtering strength | Integer 0-4 | none |
| luminance-qp-bias | Adjusts frame QP based on average luma | Integer 0-100 | none |
| sharpness | Bias towards decreased/increased sharpness | Integer -7 to 7 | none |
GOP and Temporal Structure Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| preset | Encoder preset (higher = faster, lower quality) | Integer -1 to 13 | none |
| keyint | GOP size in frames | Integer >= -2 (-2: ~5 seconds, -1: infinite for CRF) | none |
| irefresh-type | Intra refresh type | 1 – FWD Frame (Open GOP) 2 – KEY Frame (Closed GOP) | none |
| scd | Scene change detection control | 0 – off 1 – on | none |
| lookahead | Number of frames to look ahead | Integer -1 to 120 (-1: auto) | none |
| hierarchical-levels | Hierarchical levels beyond base layer | 2 – 3 temporal layers 3 – 4 temporal layers 4 – 5 temporal layers 5 – 6 temporal layers | none |
| pred-struct | Prediction structure | 1 – low delay frames 2 – random access | none |
| rtc | Fast settings for RTC in low-delay mode | 0 – off 1 – on | none |
Tiling Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| tile-rows | Number of tile rows (log2) | Integer 0-6 | none |
| tile-columns | Number of tile columns (log2) | Integer 0-4 | none |
AV1 Coding Tools Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| enable-dlf | Deblocking loop filter control | 0 – off 1 – on | none |
| enable-cdef | Enable Constrained Directional Enhancement Filter | 0 – off 1 – on | none |
| enable-restoration | Enable loop restoration filter | 0 – off 1 – on | none |
| enable-tpl-la | Temporal Dependency model control (CRF/CQP only) | 0 – off 1 – on | none |
| enable-mfmv | Motion Field Motion Vector control | -1 – auto 0 – off 1 – on | none |
| enable-dg | Dynamic GoP control | 0 – off 1 – on | none |
| fast-decode | Fast Decoder levels | 0, 1, or 2 | none |
| enable-tf | Enable ALT-REF (temporally filtered) frames | 0 – off 1 – on 2 – on | none |
| enable-overlays | Enable insertion of overlayer pictures | 0 – off 1 – on | none |
Tuning and Content Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| tune | Tuning metric | 0 – VQ 1 – PSNR 2 – SSIM | none |
| scm | Screen content detection level | 0 – off 1 – on 2 – content adaptive | none |
| film-grain | Film grain level (denoising level) | Integer 0-50 | none |
| film-grain-denoise | Apply denoising when film grain is ON | 0 – no denoising 1 – level set by film-grain parameter | none |
Super-Resolution Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| superres-mode | Super-resolution mode | 0 – off 1, 2, 3 – on 4 – auto-select | none |
| superres-denom | Super-resolution denominator (mode 1 only) | Integer 8-16 (8: no scaling, 16: half-scaling) | none |
| superres-kf-denom | Super-resolution denominator for key frames (mode 1 only) | Integer 8-16 | none |
| superres-qthres | Super-resolution q-threshold (mode 3 only) | Integer 0-63 | none |
| superres-kf-qthres | Super-resolution q-threshold for key frames (mode 3 only) | Integer 0-63 | none |
S-Frame Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| sframe-dist | S-Frame interval in frames | Integer >= 0 (0: off) | none |
| sframe-mode | S-Frame insertion mode | 1 – only if altref frame 2 – next altref frame | none |
Color Metadata Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| color-primaries | Color primaries | Integer 0-22 | none |
| transfer-characteristics | Transfer characteristics | Integer 0-22 | none |
| matrix-coefficients | Matrix coefficients | Integer 0-14 | none |
| color-range | Color range | 0 – Studio 1 – Full | none |
| chroma-sample-position | Chroma sample position | unknown, vertical, left, colocated, topleft | none |
Variance Boost Parameters
| Parameter | Description | Allowed Values | Default Value |
|---|---|---|---|
| enable-variance-boost | Enable variance boost | 0 – off 1 – on | none |
| variance-boost-strength | Variance boost strength | Integer 1-4 | none |
| variance-octile | Octile for variance boost | Integer 1-8 | none |