How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Amazon MediaConvert Presets API

The Presets API from Amazon MediaConvert — 2 operation(s) for presets.

Amazon MediaConvert Presets API is one of 8 APIs that Amazon MediaConvert publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Presets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, and pricing.

This API exposes 5 operations across 2 paths, and defines 488 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 4 base URLs: http://mediaconvert.{region}.amazonaws.com, https://mediaconvert.{region}.amazonaws.com, http://mediaconvert.{region}.amazonaws.com.cn, https://mediaconvert.{region}.amazonaws.com.cn.

5 operations 2 paths 488 schemas 1 DELETE2 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
http://mediaconvert.{region}.amazonaws.com
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Amazon MediaConvert Presets API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (hmac). By default, every request must be authenticated.

  • hmac — Amazon Signature authorization v4

Paths & Operations 5

Across 2 paths, the API surfaces 5 operations — 1 DELETE, 2 GET, 1 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Presets 5
POST
/2017-08-29/presets
Amazon MediaConvert Create Preset
CreatePreset 7 params body → 201480481482483484485
GET
/2017-08-29/presets
Amazon MediaConvert List Presets
ListPresets 14 params → 200480481482483484485
DELETE
/2017-08-29/presets/{name}
Amazon MediaConvert Delete Preset
DeletePreset 8 params → 202480481482483484485
GET
/2017-08-29/presets/{name}
Amazon MediaConvert Get Preset
GetPreset 8 params → 200480481482483484485
PUT
/2017-08-29/presets/{name}
Amazon MediaConvert Update Preset
UpdatePreset 8 params body → 200480481482483484485

Schemas 488

The contract defines 488 schemas that model the data the API accepts and returns. The most detailed are H264Settings (42 properties), H265Settings (41 properties), M2tsSettings (39 properties), Mpeg2Settings (33 properties). Each schema is shown below with its type and property counts.

Rectangle
object
Use Rectangle to identify a specific area of the video frame.
4 properties
H265FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
H265Telecine
string
This field applies only if the Streams Advanced Framerate (framerate) field is set to 29.970. This field works with the Streams Advanced Preprocessors Deinterl…
Vp9QualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
AvcIntraUhdSettings
object
Optional when you set AVC-Intra class (avcIntraClass) to Class 4K/2K (CLASS4K2K). When you set AVC-Intra class to a different value, this object isn't allowed.
1 property
ProresFramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
DeletePresetResponse
object
DvbNitSettings
object
Use these settings to insert a DVB Network Information Table (NIT) in the transport stream of this output. When you work directly in your JSON job specificatio…
3 properties
MovClapAtom
string
When enabled, include 'clap' atom if appropriate for the video output settings.
DropFrameTimecode
string
Applies only to 29.97 fps outputs. When this feature is enabled, the service will use drop-frame timecode on outputs. If it is not possible to use drop-frame t…
__doubleMinNegative60Max3
number
DolbyVisionLevel6Metadata
object
Use these settings when you set DolbyVisionLevel6Mode to SPECIFY to override the MaxCLL and MaxFALL values in your input with new values.
2 properties
TimecodeBurninPosition
string
Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video.
MovReference
string
Always keep the default value (SELFCONTAINED) for this setting.
Mpeg2CodecLevel
string
Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output.
XavcSpatialAdaptiveQuantization
string
The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you…
XavcGopBReference
string
Specify whether the encoder uses B-frames as reference frames for other pictures in the same GOP. Choose Allow (ENABLED) to allow the encoder to use B-frames a…
WebvttStylePassthrough
string
To use the available style, color, and position information from your input captions: Set Style passthrough (stylePassthrough) to Enabled (ENABLED). MediaConve…
Vp9RateControlMode
string
With the VP9 codec, you can use only the variable bitrate (VBR) rate control mode.
BurninSubtitleShadowColor
string
Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the…
CmfcIFrameOnlyManifest
string
Choose Include (INCLUDE) to have MediaConvert generate an HLS child manifest that lists only the I-frames for this rendition, in addition to your regular manif…
__integerMin32Max8182
integer
__integerMin10Max48
integer
BandwidthReductionFilterSharpening
string
Optionally specify the level of sharpening to apply when you use the Bandwidth reduction filter. Sharpening adds contrast to the edges of your video content an…
AudioDescription
object
Settings related to one audio tab on the MediaConvert console. In your job JSON, an instance of AudioDescription is equivalent to one audio tab in the console.…
11 properties
Eac3AtmosDialogueIntelligence
string
Enable Dolby Dialogue Intelligence to adjust loudness based on dialogue analysis.
Ac3DynamicRangeCompressionLine
string
Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operati…
DvbSubSubtitleFallbackFont
string
Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you…
Mpeg2ScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
ImscStylePassthrough
string
Keep this setting enabled to have MediaConvert use the font style and position information from the captions source in the output. This option is available onl…
H265DynamicSubGop
string
Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based o…
Eac3LfeControl
string
When encoding 3/2 audio, controls whether the LFE channel is enabled
__doubleMin0
number
DvbSubtitleOutlineColor
string
Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data…
DolbyVisionMapping
string
Required when you set Dolby Vision Profile to Profile 8.1. When you set Content mapping to None, content mapping is not applied to the HDR10-compatible signal.…
AacSpecification
string
Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers.
MpdTimedMetadataBoxVersion
string
Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. L…
__integerMin0Max1152000000
integer
SccDestinationFramerate
string
Set Framerate (SccDestinationFramerate) to make sure that the captions and the video are synchronized in the output. Specify a frame rate that matches the fram…
M2tsEbpPlacement
string
Selects which PIDs to place EBP markers on. They can either be placed only on the video PID, or on both the video PID and all audio PIDs. Only applicable when…
Av1RateControlMode
string
'With AV1 outputs, for rate control mode, MediaConvert supports only quality-defined variable bitrate (QVBR). You can''t use CBR or VBR.'
AacCodingMode
string
The Coding mode that you specify determines the number of audio channels and the audio channel layout metadata in your AAC output. Valid coding modes depend on…
Vp8QualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
Av1QvbrSettings
object
Settings for quality-defined variable bitrate encoding with the AV1 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode).
2 properties
H265FlickerAdaptiveQuantization
string
Enable this setting to have the encoder reduce I-frame pop. I-frame pop appears as a visual flicker that can arise when the encoder saves bits by copying some…
H264RateControlMode
string
Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR).
Vp8Settings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value VP8.
13 properties
__integerMin1000Max1466400000
integer
__integerMin1Max10
integer
XavcHdProfileSettings
object
Required when you set (Profile) under (VideoDescription)(CodecSettings)(XavcSettings) to the value XAVCHD.
9 properties
__integerMin0Max4000
integer
H264Telecine
string
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or…
CmfcTimedMetadataBoxVersion
string
Specify the event message box (eMSG) version for ID3 timed metadata in your output. For more information, see ISO/IEC 23009-1:2022 section 5.10.3.3.3 Syntax. L…
H264CodecProfile
string
H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License.
Xavc4kProfileCodecProfile
string
Specify the codec profile for this output. Choose High, 8-bit, 4:2:0 (HIGH) or High, 10-bit, 4:2:2 (HIGH422). These profiles are specified in ITU-T H.264.
XavcEntropyEncoding
string
Optional. Choose a specific entropy encoding mode only when you want to override XAVC recommendations. If you choose the value auto, MediaConvert uses the mode…
ContainerSettings
object
Container specific settings.
9 properties
M2tsScte35Esam
object
Settings for SCTE-35 signals from ESAM. Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion poin…
1 property
__integerMin0Max99
integer
XavcAdaptiveQuantization
string
Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you…
Mpeg2TemporalAdaptiveQuantization
string
Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this fea…
__stringMin6Max8Pattern09aFAF609aFAF2
string
H264SlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL,…
Mpeg2GopSizeUnits
string
Specify the units for GOP size (GopSize). If you don't specify a value here, by default the encoder measures GOP size in frames.
__integerMin0Max7
integer
VideoDescription
object
Settings related to video encoding of your output. The specific video settings depend on the video codec that you choose. When you work directly in your JSON j…
15 properties
BurninSubtitleTeletextSpacing
string
Specify whether the text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXEDG…
__listOf__integerMin32Max8182
array
M2tsAudioDuration
string
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between v…
__integerMinNegative1Max10
integer
__stringPatternWS
string
TeletextDestinationSettings
object
Settings related to teletext captions. Set up teletext captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaco…
2 properties
AacRateControlMode
string
Rate Control Mode.
H264DynamicSubGop
string
Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based o…
BandwidthReductionFilter
object
The Bandwidth reduction filter increases the video quality of your output relative to its bitrate. Use to lower the bitrate of your constant quality QVBR outpu…
2 properties
MovPaddingControl
string
Unless you need Omneon compatibility: Keep the default value, None. To make this output compatible with Omneon: Choose Omneon. When you do, MediaConvert increa…
AudioNormalizationAlgorithmControl
string
When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted.
__integerMin96Max600
integer
H265GopSizeUnits
string
Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on char…
__integerMin4Max12
integer
ScalingBehavior
string
Specify how the service handles outputs that have a different aspect ratio from the input aspect ratio. Choose Stretch to output (STRETCHTOOUTPUT) to have the…
M2tsRateMode
string
When set to CBR, inserts null packets into transport stream to fill specified bitrate. When set to VBR, the bitrate setting acts as the maximum bitrate, but th…
Eac3AtmosDynamicRangeCompressionLine
string
Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the line operating mode. Default…
__integerMin100Max1000
integer
__listOf__doubleMinNegative60Max6
array
__integerMin0Max1
integer
__integerMin0Max500
integer
NoiseReducerTemporalFilterSettings
object
Noise reducer filter settings for temporal filter.
5 properties
ProresTelecine
string
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard tel…
__integerMin1000Max30000
integer
Mpeg2FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
M2tsScte35Source
string
For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Cho…
Vp8ParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
ProresSettings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value PRORES.
13 properties
MpdScte35Source
string
Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your…
RemixSettings
object
Use Manual audio remixing (RemixSettings) to adjust audio levels for each audio channel in each output of your job. With audio remixing, you can output more or…
3 properties
M2tsEbpAudioInterval
string
When set to VIDEOANDFIXEDINTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and wil…
TeletextPageType
string
A page type as defined in the standard ETSI EN 300 468, Table 94
Xavc4kProfileQualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
__integerMin1Max1001
integer
M2tsPcrControl
string
When set to PCREVERYPESPACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the…
AvcIntraInterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
__listOfOutputChannelMapping
array
MxfSettings
object
These settings relate to your MXF output container.
3 properties
CmfcTimedMetadata
string
To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserte…
DvbSubtitleTeletextSpacing
string
Specify whether the Text spacing (TeletextSpacing) in your captions is set by the captions grid, or varies depending on letter width. Choose fixed grid (FIXEDG…
H265AlternateTransferFunctionSei
string
Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF).
DvbTdtSettings
object
Use these settings to insert a DVB Time and Date Table (TDT) in the transport stream of this output. When you work directly in your JSON job specification, inc…
1 property
Ac3DynamicRangeCompressionRf
string
Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating…
XavcSettings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value XAVC.
16 properties
AudioNormalizationLoudnessLogging
string
If set to LOG, log each output's audio track loudness to a CSV file.
SrtDestinationSettings
object
Settings related to SRT captions. SRT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in t…
1 property
Mpeg2RateControlMode
string
Use Rate control mode (Mpeg2RateControlMode) to specify whether the bitrate is variable (vbr) or constant (cbr).
XavcHdIntraCbgProfileSettings
object
Required when you set (Profile) under (VideoDescription)(CodecSettings)(XavcSettings) to the value XAVCHDINTRACBG.
1 property
__integerMinNegative5Max10
integer
__integerMin0Max1466400000
integer
H264QualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
AudioChannelTaggingSettings
object
When you mimic a multi-channel audio layout with multiple mono-channel tracks, you can tag each channel layout manually. For example, you would tag the tracks…
1 property
__listOfPreset
array
VideoPreprocessor
object
Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by…
8 properties
ForbiddenException
DeinterlacerMode
string
Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. -…
__integerMin0Max10
integer
AacSettings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settin…
9 properties
XavcHdIntraCbgProfileClass
string
Specify the XAVC Intra HD (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that ar…
Vc3InterlaceMode
string
Optional. Choose the scan line type for this output. If you don't specify a value, MediaConvert will create a progressive output.
Mpeg2Syntax
string
Specify whether this output's video uses the D10 syntax. Keep the default value to not use the syntax. Related settings: When you choose D10 (D10) for your MXF…
AvcIntraSlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL,…
MovSettings
object
These settings relate to your QuickTime MOV output container.
5 properties
__integerMin32000Max48000
integer
AudioCodecSettings
object
Settings related to audio encoding. The settings in this group vary depending on the value that you choose for your audio codec.
11 properties
Eac3Settings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value EAC3.
21 properties
Eac3AtmosBitstreamMode
string
Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E).
M3u8NielsenId3
string
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.
DeinterlacerControl
string
- When set to NORMAL (default), the deinterlacer does not convert frames that are tagged in metadata as progressive. It will only convert those that are tagged…
__integerMinNegative2147483648Max2147483647
integer
Mpeg2SceneChangeDetect
string
Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default.
AudioCodec
string
Choose the audio codec for this output. Note that the option Dolby Digital passthrough (PASSTHROUGH) applies only to Dolby Digital and Dolby Digital Plus audio…
M2tsBufferModel
string
Controls what buffer model to use for accurate interleaving. If set to MULTIPLEX, use multiplex buffer model. If set to NONE, this can lead to lower latency, b…
XavcTemporalAdaptiveQuantization
string
The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (adaptiveQuantization). When you…
Av1BitDepth
string
Specify the Bit depth (Av1BitDepth). You can choose 8-bit (BIT8) or 10-bit (BIT10).
__doubleMin0Max1
number
M3u8Scte35Source
string
For SCTE-35 markers from your input-- Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your input to also appear in this output. Cho…
__integerMinNegative60Max6
integer
Eac3AtmosCodingMode
string
The coding mode for Dolby Digital Plus JOC (Atmos).
ProresInterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
Mp4Settings
object
These settings relate to your MP4 output container. You can create audio only outputs with this container. For more information, see https://docs.aws.amazon.co…
6 properties
BurninSubtitleFontColor
string
Specify the color of the burned-in captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font co…
DvbSubtitleBackgroundColor
string
Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled…
TimedMetadata
string
Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH) to include ID3 metadata in this output. This includes ID3 metadata from the following features: I…
H265RateControlMode
string
Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR).
XavcFramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
Mpeg2Settings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value MPEG2.
33 properties
CmfcScte35Source
string
Ignore this setting unless you have SCTE-35 markers in your input video file. Choose Passthrough (PASSTHROUGH) if you want SCTE-35 markers that appear in your…
Mpeg2DynamicSubGop
string
Choose Adaptive to improve subjective video quality for high-motion content. This will cause the service to use fewer B-frames (which infer information based o…
__integerMin0Max128
integer
__integerMin22050Max48000
integer
__stringMin1Max256
string
Eac3AtmosMeteringMode
string
Choose how the service meters the loudness of your audio.
InternalServerErrorException
Eac3BitstreamMode
string
Specify the bitstream mode for the E-AC-3 stream that the encoder emits. For more information about the EAC3 bitstream mode, see ATSC A/52-2012 (Annex E).
H265ParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
M2tsKlvMetadata
string
To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and passe…
DolbyVision
object
Create Dolby Vision Profile 5 or Profile 8.1 compatible video output.
4 properties
Ac3MetadataControl
string
When set to FOLLOWINPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one…
Eac3AtmosStereoDownmix
string
Choose how the service does stereo downmixing. Default value: Not indicated (ATMOSSTORAGEDDPDMIXMODNOTINDICATED) Related setting: To have MediaConvert use this…
H264FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
OpusSettings
object
Required when you set Codec, under AudioDescriptionsCodecSettings, to the value OPUS.
3 properties
MxfProfile
string
Specify the MXF profile, also called shim, for this output. When you choose Auto, MediaConvert chooses a profile based on the video codec and resolution. For a…
AvcIntraFramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
Vc3Class
string
Specify the VC3 class to choose the quality characteristics for this output. VC3 class, together with the settings Framerate (framerateNumerator and framerateD…
DvbSubtitleApplyFontColor
string
Ignore this setting unless Style Passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Us…
Vp8RateControlMode
string
With the VP8 codec, you can use only the variable bitrate (VBR) rate control mode.
DvbSubDestinationSettings
object
Settings related to DVB-Sub captions. Set up DVB-Sub captions in the same output as your video. For more information, see https://docs.aws.amazon.com/mediaconv…
27 properties
BurninSubtitleApplyFontColor
string
Ignore this setting unless Style passthrough (StylePassthrough) is set to Enabled and Font color (FontColor) set to Black, Yellow, Red, Green, Blue, or Hex. Us…
M2tsForceTsVideoEbpOrder
string
Keep the default value (DEFAULT) unless you know that your audio EBP markers are incorrectly appearing before your video EBP markers. To correct this problem,…
BadRequestException
XavcSlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video fra…
H264SpatialAdaptiveQuantization
string
Only use this setting when you change the default value, Auto (AUTO), for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264Adapt…
Preset
object
A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.
8 properties 2 required
Eac3AtmosDynamicRangeControl
string
Specify whether MediaConvert should use any dynamic range control metadata from your input file. Keep the default value, Custom (SPECIFIED), to provide dynamic…
Xavc4kIntraVbrProfileSettings
object
Required when you set (Profile) under (VideoDescription)(CodecSettings)(XavcSettings) to the value XAVC4KINTRAVBR.
1 property
AudioNormalizationAlgorithm
string
Choose one of the following audio normalization algorithms: ITU-R BS.1770-1: Ungated loudness. A measurement of ungated average loudness for an entire piece of…
NoiseReducerFilterSettings
object
Settings for a noise reducer filter
1 property
ColorCorrector
object
Settings for color correction.
10 properties
__integerMin1Max10000000
integer
BurninSubtitleFallbackFont
string
Specify the font that you want the service to use for your burn in captions when your input captions specify a font that MediaConvert doesn't support. When you…
F4vSettings
object
Settings for F4v container
1 property
__integerMin16000Max48000
integer
Av1Settings
object
Required when you set Codec, under VideoDescriptionCodecSettings to the value AV1.
13 properties
Av1FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
__string
string
InsertableImage
object
These settings apply to a specific graphic overlay. You can include multiple overlays in your job.
11 properties
TtmlStylePassthrough
string
Pass through style and position information from a TTML-like input source (TTML, IMSC, SMPTE-TT) to the TTML output.
Mpeg2SpatialAdaptiveQuantization
string
Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feat…
Vc3FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
__integerMin0Max1000
integer
H264QvbrSettings
object
Settings for quality-defined variable bitrate encoding with the H.264 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode).
3 properties
__integerMin0Max96
integer
SrtStylePassthrough
string
Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses def…
__integerMin6000Max1024000
integer
Mpeg2SlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL,…
ClipLimits
object
Specify YUV limits and RGB tolerances when you set Sample range conversion to Limited range clip.
4 properties
MpdAudioDuration
string
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between v…
AntiAlias
string
The anti-alias filter is automatically applied to all outputs. The service no longer accepts the value DISABLED for AntiAlias. If you specify that in your job,…
Eac3PhaseControl
string
Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode.
Eac3AtmosSettings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value EAC3ATMOS.
17 properties
__integerMin48000Max48000
integer
RespondToAfd
string
Use Respond to AFD (RespondToAfd) to specify how the service changes the video itself in response to AFD values in the input. Choose Respond to clip the input…
M2tsSegmentationMarkers
string
Inserts segmentation markers at each segmentationtime period. raisegstart sets the Random Access Indicator bit in the adaptation field. raiadapt sets the RAI b…
H264GopSizeUnits
string
Specify how the transcoder determines GOP size for this output. We recommend that you have the transcoder automatically choose this value for you based on char…
ImscDestinationSettings
object
Settings related to IMSC captions. IMSC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in…
2 properties
__integerMinNegative1Max3
integer
M2tsSettings
object
MPEG-2 TS container settings. These apply to outputs in a File output group when the output's container (ContainerType) is MPEG-2 Transport Stream (M2TS). In t…
39 properties
H264ParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
Vp9Settings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value VP9.
13 properties
Mpeg2QualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
BurninSubtitleBackgroundColor
string
Specify the color of the rectangle behind the captions. Leave background color (BackgroundColor) blank and set Style passthrough (StylePassthrough) to enabled…
H265TemporalAdaptiveQuantization
string
Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on temporal variation of content complexity. When you enable this fea…
DvbSubtitleFontColor
string
Specify the color of the captions text. Leave Font color (FontColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font color data f…
TimecodeBurnin
object
Settings for burning the output timecode and specified prefix into the output.
3 properties
ColorSpaceConversion
string
Specify the color space you want for this output. The service supports conversion between HDR formats, between SDR formats, from SDR to HDR, and from HDR to SD…
ProresCodecProfile
string
Use Profile (ProResCodecProfile) to specify the type of Apple ProRes codec to use for this output.
H265TemporalIds
string
Enables temporal layer identifiers in the encoded bitstream. Up to 3 layers are supported depending on GOP structure: I- and P-frames form one layer, reference…
Vp8FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
Eac3AtmosDownmixControl
string
Specify whether MediaConvert should use any downmix metadata from your input file. Keep the default value, Custom (SPECIFIED) to provide downmix values in your…
Vc3Settings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value VC3
9 properties
MpdScte35Esam
string
Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify…
__integerMin90Max105
integer
H265WriteMp4PackagingType
string
If the location of parameter set NAL units doesn't matter in your workflow, ignore this setting. Use this setting only with CMAF or DASH outputs, or with stand…
M3u8AudioDuration
string
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between v…
M2tsDataPtsControl
string
If you select ALIGNTOVIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video pac…
__doubleMinNegative6Max3
number
UpdatePresetResponse
object
1 property
H265InterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
__integerMin0Max47185920
integer
AvcIntraTelecine
string
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard tel…
__doubleMinNegative60Max6
number
__integerMin1Max6
integer
BurnInSubtitleStylePassthrough
string
Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses def…
Xavc4kProfileBitrateClass
string
Specify the XAVC 4k (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points…
__integerMin1000Max288000000
integer
CreatePresetResponse
object
1 property
XavcHdProfileBitrateClass
string
Specify the XAVC HD (Long GOP) Bitrate Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points…
CmfcAudioTrackType
string
Use this setting to control the values that MediaConvert puts in your HLS parent playlist to control how the client player selects which audio track to play. T…
Vp9FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
H265Settings
object
Settings for H265 codec
41 properties
M2tsEsRateInPes
string
Controls whether to include the ES Rate field in the PES header.
Ac3BitstreamMode
string
Specify the bitstream mode for the AC-3 stream that the encoder emits. For more information about the AC3 bitstream mode, see ATSC A/52-2012 (Annex E).
BurninDestinationSettings
object
Burn-in is a captions delivery method, rather than a captions format. Burn-in writes the captions directly on your video frames, replacing pixels of video cont…
21 properties
__integerMinNegative2Max3
integer
DolbyVisionLevel6Mode
string
Use Dolby Vision Mode to choose how the service will handle Dolby Vision MaxCLL and MaxFALL properies.
__integerMin0Max2147483647
integer
__integerMin1000Max480000000
integer
__integerMin1Max4
integer
__integerMin1Max100
integer
Eac3SurroundExMode
string
When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels.
ContainerType
string
Container for this output. Some containers require a container settings object. If not specified, the default object will be created.
ConflictException
H265UnregisteredSeiTimecode
string
Inserts timecode for each frame as 4 bytes of an unregistered SEI message.
TooManyRequestsException
FontScript
string
Provide the font script, using an ISO 15924 script code, if the LanguageCode is not sufficient for determining the script type. Where LanguageCode or CustomLan…
ChannelMapping
object
Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel, in dB. Specify remix values to indicate how much o…
1 property
__listOfCaptionDescriptionPreset
array
DvbSubtitlingType
string
Specify whether your DVB subtitles are standard or for hearing impaired. Choose hearing impaired if your subtitles include audio descriptions and dialogue. Cho…
MxfAfdSignaling
string
Optional. When you have AFD signaling set up in your output video stream, use this setting to choose whether to also include it in the MXF wrapper. Choose Don'…
MovCslgAtom
string
When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a…
H265AdaptiveQuantization
string
When you set Adaptive Quantization (H265AdaptiveQuantization) to Auto (AUTO), or leave blank, MediaConvert automatically applies quantization to improve the vi…
__doubleMinNegative59Max0
number
CmfcManifestMetadataSignaling
string
To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messa…
XavcHdProfileTelecine
string
Ignore this setting unless you set Frame rate (framerateNumerator divided by framerateDenominator) to 29.970. If your input framerate is 23.976, choose Hard (H…
CmfcAudioDuration
string
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between v…
H264Settings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value H264.
42 properties
__integerMin25Max2000
integer
Mpeg2InterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
__stringMin3Max3Pattern1809aFAF09aEAE
string
__integerMinNegative70Max0
integer
Mp2Settings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value MP2.
3 properties
WavFormat
string
The service defaults to using RIFF for WAV outputs. If your output audio is likely to exceed 4 GB in file size, or if you otherwise need the extended support o…
M3u8PcrControl
string
When set to PCREVERYPESPACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only…
__doubleMinNegative20Max0
number
Mp3RateControlMode
string
Specify whether the service encodes this MP3 audio output with a constant bitrate (CBR) or a variable bitrate (VBR).
H265SampleAdaptiveOffsetFilterMode
string
Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content
MxfXavcProfileSettings
object
Specify the XAVC profile settings for MXF outputs when you set your MXF profile to XAVC.
2 properties
NotFoundException
Eac3DynamicRangeCompressionLine
string
Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the line operati…
Eac3DynamicRangeCompressionRf
string
Choose the Dolby Digital dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby Digital stream for the RF operating…
DeinterlaceAlgorithm
string
Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produce…
MpdTimedMetadata
string
To include ID3 metadata in this output: Set ID3 metadata (timedMetadata) to Passthrough (PASSTHROUGH). Specify this ID3 metadata in Custom ID3 metadata inserte…
__integerMin1Max2147483647
integer
MpdManifestMetadataSignaling
string
To add an InbandEventStream element in your output MPD manifest for each type of event message, set Manifest metadata signaling to Enabled. For ID3 event messa…
CmfcScte35Esam
string
Use this setting only when you specify SCTE-35 markers from ESAM. Choose INSERT to put SCTE-35 markers in this output at the insertion points that you specify…
NoiseFilterPostTemporalSharpeningStrength
string
Use Post temporal sharpening strength (postTemporalSharpeningStrength) to define the amount of sharpening the transcoder applies to your output. Set Post tempo…
Hdr10Plus
object
Setting for HDR10+ metadata insertion
2 properties
__integerMin8000Max96000
integer
__doubleMinNegative60MaxNegative1
number
__integerMin8Max12
integer
H265CodecLevel
string
H.265 Level.
AacRawFormat
string
Enables LATM/LOAS AAC output. Note that if you use LATM/LOAS AAC in an output, you must choose "No container" for the output container.
VideoCodec
string
Type of video codec
H265CodecProfile
string
Represents the Profile and Tier, per the HEVC (H.265) specification. Selections are grouped as [Profile] / [Tier], so "Main/High" represents Main Profile with…
AiffSettings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value AIFF.
3 properties
NexGuardFileMarkerSettings
object
For forensic video watermarking, MediaConvert supports Nagra NexGuard File Marker watermarking. MediaConvert supports both PreRelease Content (NGPR/G2) and OTT…
4 properties
XavcHdProfileQualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
AvcIntraUhdQualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how many transcoding passes MediaConvert does with your video. When you choose Multi-pass (MU…
SccDestinationSettings
object
Settings related to SCC captions. SCC is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in t…
1 property
Mpeg2ParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
H264UnregisteredSeiTimecode
string
Inserts timecode for each frame as 4 bytes of an unregistered SEI message.
M3u8Settings
object
These settings relate to the MPEG-2 transport stream (MPEG2-TS) container for the MPEG2-TS segments in your HLS outputs.
19 properties
CaptionDescriptionPreset
object
Caption Description for preset
4 properties
H264TemporalAdaptiveQuantization
string
Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuan…
__integerMin1000Max1152000000
integer
Xavc4kIntraVbrProfileClass
string
Specify the XAVC Intra 4k (VBR) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that ar…
Eac3MetadataControl
string
When set to FOLLOWINPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one…
H264FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
AudioNormalizationPeakCalculation
string
If set to TRUEPEAK, calculate and log the TruePeak for each output's audio track loudness.
Eac3AttenuationControl
string
If set to ATTENUATE3DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode.
AacCodecProfile
string
AAC Profile.
CmfcDescriptiveVideoServiceFlag
string
Specify whether to flag this audio track as descriptive video service (DVS) in your HLS parent manifest. When you choose Flag (FLAG), MediaConvert includes the…
__integerMin0Max100
integer
__integerMin25Max10000
integer
CmfcSettings
object
These settings relate to the fragmented MP4 container for the segments in your CMAF outputs.
14 properties
__stringMin1Max100000
string
OutputSdt
string
Selects method of inserting SDT information into output stream. "Follow input SDT" copies SDT information from input stream to output stream. "Follow input SDT…
AudioTypeControl
string
When set to FOLLOWINPUT, if the input contains an ISO 639 audiotype, then that value is passed through to the output. If the input contains no ISO 639 audiotyp…
__integerMin1Max64
integer
Eac3AtmosDynamicRangeCompressionRf
string
Choose the Dolby dynamic range control (DRC) profile that MediaConvert uses when encoding the metadata in the Dolby stream for the RF operating mode. Default v…
NoiseReducer
object
Enable the Noise reducer feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting…
4 properties
__integerMin64000Max640000
integer
__stringMin14PatternS3BmpBMPPngPNGTgaTGAHttpsBmpBMPPngPNGTgaTGA
string
M2tsSegmentationStyle
string
The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be tru…
BurninSubtitleOutlineColor
string
Specify font outline color. Leave Outline color (OutlineColor) blank and set Style passthrough (StylePassthrough) to enabled to use the font outline color data…
AudioChannelTag
string
You can add a tag for this mono-channel audio track to mimic its placement in a multi-channel layout. For example, if this track is the left surround channel,…
M3u8DataPtsControl
string
If you select ALIGNTOVIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video pac…
__integerMin0Max4
integer
ImscAccessibilitySubs
string
Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. Wh…
Eac3CodingMode
string
Dolby Digital Plus coding mode. Determines number of channels.
H265GopBReference
string
If enable, use reference B frames for GOP structures that have B frames 1.
AacAudioDescriptionBroadcasterMix
string
Choose BROADCASTERMIXEDAD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, whi…
__integerMin32000Max384000
integer
Mpeg2IntraDcPrecision
string
Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will au…
WebvttDestinationSettings
object
Settings related to WebVTT captions. WebVTT is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar caption…
2 properties
Vc3FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
Xavc4kIntraCbgProfileClass
string
Specify the XAVC Intra 4k (CBG) Class to set the bitrate of your output. Outputs of the same class have similar image quality over the operating points that ar…
CmfcKlvMetadata
string
To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and write…
Xavc4kProfileSettings
object
Required when you set (Profile) under (VideoDescription)(CodecSettings)(XavcSettings) to the value XAVC4K.
8 properties
H264FieldEncoding
string
The video encoding method for your MPEG-4 AVC output. Keep the default value, PAFF, to have MediaConvert use PAFF encoding for interlaced outputs. Choose Force…
__listOfInsertableImage
array
__integerMin1Max32
integer
Eac3DcFilter
string
Activates a DC highpass filter for all input channels.
XavcProfile
string
Specify the XAVC profile for this output. For more information, see the Sony documentation at https://www.xavc-info.org/. Note that MediaConvert doesn't suppor…
__integerMin24Max60000
integer
H265SlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL,…
AudioNormalizationSettings
object
Advanced audio normalization settings. Ignore these settings unless you need to comply with a loudness standard.
7 properties
H264ScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
H264FlickerAdaptiveQuantization
string
Only use this setting when you change the default value, AUTO, for the setting H264AdaptiveQuantization. When you keep all defaults, excluding H264AdaptiveQuan…
AudioLanguageCodeControl
string
Specify which source for language code takes precedence for this audio track. When you choose Follow input (FOLLOWINPUT), the service uses the language code fr…
H264SceneChangeDetect
string
Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this…
ProresChromaSampling
string
This setting applies only to ProRes 4444 and ProRes 4444 XQ outputs that you create from inputs that use 4:4:4 chroma sampling. Set Preserve 4:4:4 sampling (PR…
VorbisSettings
object
Required when you set Codec, under AudioDescriptionsCodecSettings, to the value Vorbis.
3 properties
H264Syntax
string
Produces a bitstream compliant with SMPTE RP-2027.
Mp4FreeSpaceBox
string
Inserts a free-space box immediately after the moov box.
Eac3LfeFilter
string
Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 32LFE coding mode.
__integerMin1Max31
integer
__integerMin1Max2
integer
Ac3Settings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value AC3.
10 properties
H265QvbrSettings
object
Settings for quality-defined variable bitrate encoding with the H.265 codec. Use these settings only when you set QVBR for Rate control mode (RateControlMode).
3 properties
ColorMetadata
string
Choose Insert (INSERT) for this setting to include color metadata in this output. Choose Ignore (IGNORE) to exclude color metadata from this output. If you don…
DvbddsHandling
string
Specify how MediaConvert handles the display definition segment (DDS). To exclude the DDS from this set of captions: Keep the default, None. To include the DDS…
AvcIntraClass
string
Specify the AVC-Intra class of your output. The AVC-Intra class selection determines the output video bit rate depending on the frame rate of the output. Outpu…
MxfXavcDurationMode
string
To create an output that complies with the XAVC file format guidelines for interoperability, keep the default value, Drop frames for compliance (DROPFRAMESFORC…
H264AdaptiveQuantization
string
Keep the default value, Auto (AUTO), for this setting to have MediaConvert automatically apply the best types of quantization for your video content. When you…
DvbSdtSettings
object
Use these settings to insert a DVB Service Description Table (SDT) in the transport stream of this output. When you work directly in your JSON job specificatio…
4 properties
H264InterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
Eac3PassthroughControl
string
When set to WHENPOSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Input…
NoiseReducerSpatialFilterSettings
object
Noise reducer filter settings for spatial filter.
3 properties
MpdSettings
object
These settings relate to the fragmented MP4 container for the segments in your DASH outputs.
11 properties
Av1FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
ImageInserter
object
Use the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input or output individually. For more infor…
2 properties
Av1SpatialAdaptiveQuantization
string
Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feat…
M2tsAudioBufferModel
string
Selects between the DVB and ATSC buffer models for Dolby Digital audio.
WatermarkingStrength
string
Optional. Ignore this setting unless Nagra support directs you to specify a value. When you don't specify a value here, the Nagra NexGuard library uses its def…
NoiseReducerFilter
string
Use Noise reducer filter (NoiseReducerFilter) to select one of the following spatial image filtering functions. To use this setting, you must also enable Noise…
__integerMin0Max3
integer
H265Tiles
string
Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures.
__integerMin0Max65535
integer
Eac3StereoDownmix
string
Choose how the service does stereo downmixing. This setting only applies if you keep the default value of 3/2 - L, R, C, Ls, Rs (CODINGMODE32) for the setting…
ProresParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
__integerMin920Max1023
integer
M2tsNielsenId3
string
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.
H265QualityTuningLevel
string
Optional. Use Quality tuning level (qualityTuningLevel) to choose how you want to trade off encoding speed for output video quality. The default behavior is fa…
__integerMin1000Max300000000
integer
MovMpeg2FourCCControl
string
When set to XDCAM, writes MPEG2 video streams into the QuickTime file using XDCAM fourcc codes. This increases compatibility with Apple editors and players, bu…
DolbyVisionProfile
string
Required when you enable Dolby Vision. Use Profile 5 to include frame-interleaved Dolby Vision metadata in your output. Your input must include Dolby Vision me…
BandwidthReductionFilterStrength
string
Specify the strength of the Bandwidth reduction filter. For most workflows, we recommend that you choose Auto to reduce the bandwidth of your output with littl…
H264RepeatPps
string
Places a PPS header on each encoded picture, even if repeated.
Vp8FramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
Av1AdaptiveQuantization
string
Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to Spatial adaptive quantization (spatialAdap…
__integerMin32Max8192
integer
__integerMin32000Max192000
integer
DvbSubtitleAlignment
string
Specify the alignment of your captions. If no explicit xposition is provided, setting alignment to centered will placethe captions at the bottom center of the…
GetPresetResponse
object
1 property
Eac3AtmosSurroundExMode
string
Specify whether your input audio has an additional center rear surround channel matrix encoded into your left and right surround channels.
OutputChannelMapping
object
OutputChannel mapping settings.
2 properties
FrameCaptureSettings
object
Required when you set (Codec) under (VideoDescription)(CodecSettings) to the value FRAMECAPTURE.
4 properties
Vc3SlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output by relabeling the video fra…
Xavc4kIntraCbgProfileSettings
object
Required when you set (Profile) under (VideoDescription)(CodecSettings)(XavcSettings) to the value XAVC4KINTRACBG.
1 property
Ac3DynamicRangeCompressionProfile
string
When you want to add Dolby dynamic range compression (DRC) signaling to your output stream, we recommend that you use the mode-specific settings instead of Dyn…
Vc3Telecine
string
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard tel…
EmbeddedDestinationSettings
object
Settings related to CEA/EIA-608 and CEA/EIA-708 (also called embedded or ancillary) captions. Set up embedded captions in the same output as your video. For mo…
2 properties
__stringPattern01D20305D205D
string
AvcIntraFramerateConversionAlgorithm
string
Choose the method that you want MediaConvert to use when increasing or decreasing the frame rate. We recommend using drop duplicate (DUPLICATEDROP) for numeric…
MpdAccessibilityCaptionHints
string
Optional. Choose Include (INCLUDE) to have MediaConvert mark up your DASH manifest with elements for embedded 608 captions. This markup isn't generally require…
Eac3SurroundMode
string
When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels.
SampleRangeConversion
string
Specify how MediaConvert limits the color sample range for this output. To create a limited range output from a full range input: Choose Limited range squeeze.…
HDRToSDRToneMapper
string
Specify how MediaConvert maps brightness and colors from your HDR input to your SDR output. The mode that you select represents a creative choice, with differe…
H265SceneChangeDetect
string
Enable this setting to insert I-frames at scene changes that the service automatically detects. This improves video quality and is enabled by default. If this…
__integerMin0Max30
integer
ProresSlowPal
string
Ignore this setting unless your input frame rate is 23.976 or 24 frames per second (fps). Enable slow PAL to create a 25 fps output. When you enable slow PAL,…
__stringMax1000
string
Mpeg2FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
__integerMin0Max9
integer
__listOfTeletextPageType
array
H265SpatialAdaptiveQuantization
string
Keep the default value, Enabled (ENABLED), to adjust quantization within each frame based on spatial variation of content complexity. When you enable this feat…
PartnerWatermarking
object
If you work with a third party video watermarking partner, use the group of settings that correspond with your watermarking partner to include watermarks in yo…
1 property
ProresFramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
__integerMin0Max4194303
integer
PresetSettings
object
Settings for preset
4 properties
H265ScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
__integerMin384000Max1024000
integer
__integerMin2Max2147483647
integer
__integerMin8000Max192000
integer
Type
string
AacVbrQuality
string
VBR Quality Level - Only used if ratecontrolmode is VBR.
__timestampUnix
string
__integerMin16Max24
integer
F4vMoovPlacement
string
If set to PROGRESSIVEDOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed norma…
Mpeg2Telecine
string
When you do frame rate conversion from 23.976 frames per second (fps) to 29.97 fps, and your output scan type is interlaced, you can optionally enable hard or…
MpdCaptionContainerType
string
Use this setting only in DASH output groups that include sidecar TTML or IMSC captions. You specify sidecar captions in a separate output from your audio and v…
AvcIntraSettings
object
Required when you choose AVC-Intra for your output video codec. For more information about the AVC-Intra settings, see the relevant specification. For detailed…
10 properties
__integerMinNegative180Max180
integer
Vc3ScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
Ac3CodingMode
string
Dolby Digital coding mode. Determines number of channels.
DvbSubtitleStylePassthrough
string
Set Style passthrough (StylePassthrough) to ENABLED to use the available style, color, and position information from your input captions. MediaConvert uses def…
XavcFlickerAdaptiveQuantization
string
The best way to set up adaptive quantization is to keep the default value, Auto (AUTO), for the setting Adaptive quantization (XavcAdaptiveQuantization). When…
AvcIntraScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
LanguageCode
string
Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/codelist.php.
Vp9ParControl
string
Optional. Specify how the service determines the pixel aspect ratio (PAR) for this output. The default behavior, Follow source (INITIALIZEFROMSOURCE), uses the…
__integerMin0Max16
integer
Hdr10Metadata
object
Use these settings to specify static color calibration metadata, as defined by SMPTE ST 2086. These values don't affect the pixel values that are encoded in th…
12 properties
__stringPattern
string
BurninSubtitleAlignment
string
Specify the alignment of your captions. If no explicit xposition is provided, setting alignment to centered will placethe captions at the bottom center of the…
WebvttAccessibilitySubs
string
Set Accessibility subtitles to Enabled if the ISMC or WebVTT captions track is intended to provide accessibility for people who are deaf or hard of hearing. Wh…
XavcInterlaceMode
string
Choose the scan line type for the output. Keep the default value, Progressive (PROGRESSIVE) to create a progressive output, regardless of the scan type of your…
Mp4MoovPlacement
string
If set to PROGRESSIVEDOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed norma…
ProresScanTypeConversionMode
string
Use this setting for interlaced outputs, when your output frame rate is half of your input frame rate. In this situation, choose Optimized interlacing (INTERLA…
VideoTimecodeInsertion
string
Applies only to H.264, H.265, MPEG2, and ProRes outputs. Only enable Timecode insertion when the input frame rate is identical to the output frame rate. To inc…
WavSettings
object
Required when you set (Codec) under (AudioDescriptions)(CodecSettings) to the value WAV.
4 properties
Vp9FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
H264GopBReference
string
If enable, use reference B frames for GOP structures that have B frames 1.
AfdSignaling
string
This setting only applies to H.264, H.265, and MPEG2 outputs. Use Insert AFD signaling (AfdSignaling) to specify whether the service includes AFD values in the…
ListPresetsResponse
object
2 properties
CaptionDestinationType
string
Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Note that your choice of video output container con…
H264CodecLevel
string
Specify an H.264 level that is consistent with your output video settings. If you aren't sure what level to specify, choose Auto (AUTO).
VideoCodecSettings
object
Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depen…
12 properties
NoiseFilterPostTemporalSharpening
string
When you set Noise reducer (noiseReducer) to Temporal (TEMPORAL), the bandwidth and sharpness of your output is reduced. You can optionally use Post temporal s…
__integerMin0Max50000
integer
Ac3LfeFilter
string
Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 32LFE coding mode.
MpdKlvMetadata
string
To include key-length-value metadata in this output: Set KLV metadata insertion to Passthrough. MediaConvert reads KLV metadata present in your input and write…
__integerMin32000Max3024000
integer
__integerMin0Max255
integer
XavcFramerateControl
string
If you are using the console, use the Frame rate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
CaptionDestinationSettings
object
Settings related to one captions tab on the MediaConvert console. In your job JSON, an instance of captions DestinationSettings is equivalent to one captions t…
10 properties
H264EntropyEncoding
string
Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC.
H265FramerateControl
string
If you are using the console, use the Framerate setting to specify the frame rate for this output. If you want to keep the same frame rate as the input video,…
__listOfAudioDescription
array
Deinterlacer
object
Settings for deinterlacer
3 properties
__listOf__integerMinNegative60Max6
array
Mp4CslgAtom
string
When enabled, file composition times will start at zero, composition times in the 'ctts' (composition time to sample) box for B-frames will be negative, and a…
Mpeg2AdaptiveQuantization
string
Specify the strength of any adaptive quantization filters that you enable. The value that you choose here applies to the following settings: Spatial adaptive q…
__integerMin16000Max320000
integer
Mp3Settings
object
Required when you set Codec, under AudioDescriptionsCodecSettings, to the value MP3.
5 properties
DvbSubtitleShadowColor
string
Specify the color of the shadow cast by the captions. Leave Shadow color (ShadowColor) blank and set Style passthrough (StylePassthrough) to enabled to use the…
__integerMin0Max15
integer
Mpeg2CodecProfile
string
Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output.
__integerMin0Max10000
integer
TtmlDestinationSettings
object
Settings related to TTML captions. TTML is a sidecar format that holds captions in a file that is separate from the video container. Set up sidecar captions in…
1 property
__stringPatternAZaZ23AZaZ
string

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

amazon-mediaconvert-presets-api-openapi.yml Raw ↑

Other APIs Amazon MediaConvert publishes across the network.

Amazon MediaConvert Certificates API
Amazon MediaConvert Endpoints API
Amazon MediaConvert Jobs API
Amazon MediaConvert JobTemplates API
Amazon MediaConvert Policy API
Amazon MediaConvert Queues API
Amazon MediaConvert Tags API
Where this information came from

This is an independent, third-party profile of Amazon MediaConvert Presets API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.