Class: AWS.MediaConvert
- Inherits:
-
AWS.Service
- Object
- AWS.Service
- AWS.MediaConvert
- Identifier:
- mediaconvert
- API Version:
- 2017-08-29
- Defined in:
- (unknown)
Overview
Constructs a service interface object. Each API operation is exposed as a function on service.
Service Description
AWS Elemental MediaConvert
Sending a Request Using MediaConvert
var mediaconvert = new AWS.MediaConvert();
mediaconvert.associateCertificate(params, function (err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Locking the API Version
In order to ensure that the MediaConvert object uses this specific API, you can
construct the object by passing the apiVersion
option to the constructor:
var mediaconvert = new AWS.MediaConvert({apiVersion: '2017-08-29'});
You can also set the API version globally in AWS.config.apiVersions
using
the mediaconvert service identifier:
AWS.config.apiVersions = {
mediaconvert: '2017-08-29',
// other service API versions
};
var mediaconvert = new AWS.MediaConvert();
Version:
-
2017-08-29
Constructor Summary
-
new AWS.MediaConvert(options = {}) ⇒ Object
constructor
Constructs a service object.
Property Summary
-
endpoint ⇒ AWS.Endpoint
readwrite
An Endpoint object representing the endpoint URL for service requests.
Properties inherited from AWS.Service
Method Summary
-
associateCertificate(params = {}, callback) ⇒ AWS.Request
Associates an AWS Certificate Manager (ACM) Amazon Resource Name (ARN) with AWS Elemental MediaConvert.
-
cancelJob(params = {}, callback) ⇒ AWS.Request
Permanently cancel a job.
-
createJob(params = {}, callback) ⇒ AWS.Request
Create a new transcoding job.
-
createJobTemplate(params = {}, callback) ⇒ AWS.Request
Create a new job template.
-
createPreset(params = {}, callback) ⇒ AWS.Request
Create a new preset.
-
createQueue(params = {}, callback) ⇒ AWS.Request
Create a new transcoding queue.
-
deleteJobTemplate(params = {}, callback) ⇒ AWS.Request
Permanently delete a job template you have created.
-
deletePreset(params = {}, callback) ⇒ AWS.Request
Permanently delete a preset you have created.
-
deleteQueue(params = {}, callback) ⇒ AWS.Request
Permanently delete a queue you have created.
-
describeEndpoints(params = {}, callback) ⇒ AWS.Request
Send an request with an empty body to the regional API endpoint to get your account API endpoint.
-
disassociateCertificate(params = {}, callback) ⇒ AWS.Request
Removes an association between the Amazon Resource Name (ARN) of an AWS Certificate Manager (ACM) certificate and an AWS Elemental MediaConvert resource.
-
getJob(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific completed transcoding job.
-
getJobTemplate(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific job template.
-
getPreset(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific preset.
-
getQueue(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific queue.
-
listJobs(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your most recently created jobs.
-
listJobTemplates(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your job templates.
-
listPresets(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your presets.
-
listQueues(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your queues.
-
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Retrieve the tags for a MediaConvert resource.
-
tagResource(params = {}, callback) ⇒ AWS.Request
Add tags to a MediaConvert queue, preset, or job template.
-
untagResource(params = {}, callback) ⇒ AWS.Request
Remove tags from a MediaConvert queue, preset, or job template.
-
updateJobTemplate(params = {}, callback) ⇒ AWS.Request
Modify one of your existing job templates.
-
updatePreset(params = {}, callback) ⇒ AWS.Request
Modify one of your existing presets.
-
updateQueue(params = {}, callback) ⇒ AWS.Request
Modify one of your existing queues.
Methods inherited from AWS.Service
makeRequest, makeUnauthenticatedRequest, waitFor, setupRequestListeners, defineService
Constructor Details
new AWS.MediaConvert(options = {}) ⇒ Object
Constructs a service object. This object has one method for each API operation.
Examples:
Constructing a MediaConvert object
var mediaconvert = new AWS.MediaConvert({apiVersion: '2017-08-29'});
Options Hash (options):
-
params
(map)
—
An optional map of parameters to bind to every request sent by this service object. For more information on bound parameters, see "Working with Services" in the Getting Started Guide.
-
endpoint
(String)
—
The endpoint URI to send requests to. The default endpoint is built from the configured
region
. The endpoint should be a string like'https://{service}.{region}.amazonaws.com'
. -
accessKeyId
(String)
—
your AWS access key ID.
-
secretAccessKey
(String)
—
your AWS secret access key.
-
sessionToken
(AWS.Credentials)
—
the optional AWS session token to sign requests with.
-
credentials
(AWS.Credentials)
—
the AWS credentials to sign requests with. You can either specify this object, or specify the accessKeyId and secretAccessKey options directly.
-
credentialProvider
(AWS.CredentialProviderChain)
—
the provider chain used to resolve credentials if no static
credentials
property is set. -
region
(String)
—
the region to send service requests to. See AWS.MediaConvert.region for more information.
-
maxRetries
(Integer)
—
the maximum amount of retries to attempt with a request. See AWS.MediaConvert.maxRetries for more information.
-
maxRedirects
(Integer)
—
the maximum amount of redirects to follow with a request. See AWS.MediaConvert.maxRedirects for more information.
-
sslEnabled
(Boolean)
—
whether to enable SSL for requests.
-
paramValidation
(Boolean|map)
—
whether input parameters should be validated against the operation description before sending the request. Defaults to true. Pass a map to enable any of the following specific validation features:
- min [Boolean] — Validates that a value meets the min
constraint. This is enabled by default when paramValidation is set
to
true
. - max [Boolean] — Validates that a value meets the max constraint.
- pattern [Boolean] — Validates that a string value matches a regular expression.
- enum [Boolean] — Validates that a string value matches one of the allowable enum values.
- min [Boolean] — Validates that a value meets the min
constraint. This is enabled by default when paramValidation is set
to
-
computeChecksums
(Boolean)
—
whether to compute checksums for payload bodies when the service accepts it (currently supported in S3 only)
-
convertResponseTypes
(Boolean)
—
whether types are converted when parsing response data. Currently only supported for JSON based services. Turning this off may improve performance on large response payloads. Defaults to
true
. -
correctClockSkew
(Boolean)
—
whether to apply a clock skew correction and retry requests that fail because of an skewed client clock. Defaults to
false
. -
s3ForcePathStyle
(Boolean)
—
whether to force path style URLs for S3 objects.
-
s3BucketEndpoint
(Boolean)
—
whether the provided endpoint addresses an individual bucket (false if it addresses the root API endpoint). Note that setting this configuration option requires an
endpoint
to be provided explicitly to the service constructor. -
s3DisableBodySigning
(Boolean)
—
whether S3 body signing should be disabled when using signature version
v4
. Body signing can only be disabled when using https. Defaults totrue
. -
retryDelayOptions
(map)
—
A set of options to configure the retry delay on retryable errors. Currently supported options are:
- base [Integer] — The base number of milliseconds to use in the exponential backoff for operation retries. Defaults to 100 ms for all services except DynamoDB, where it defaults to 50ms.
- customBackoff [function] — A custom function that accepts a retry count
and returns the amount of time to delay in milliseconds. The
base
option will be ignored if this option is supplied.
-
httpOptions
(map)
—
A set of options to pass to the low-level HTTP request. Currently supported options are:
- proxy [String] — the URL to proxy requests through
- agent [http.Agent, https.Agent] — the Agent object to perform
HTTP requests with. Used for connection pooling. Defaults to the global
agent (
http.globalAgent
) for non-SSL connections. Note that for SSL connections, a special Agent object is used in order to enable peer certificate verification. This feature is only available in the Node.js environment. - connectTimeout [Integer] — Sets the socket to timeout after
failing to establish a connection with the server after
connectTimeout
milliseconds. This timeout has no effect once a socket connection has been established. - timeout [Integer] — Sets the socket to timeout after timeout milliseconds of inactivity on the socket. Defaults to two minutes (120000).
- xhrAsync [Boolean] — Whether the SDK will send asynchronous HTTP requests. Used in the browser environment only. Set to false to send requests synchronously. Defaults to true (async on).
- xhrWithCredentials [Boolean] — Sets the "withCredentials" property of an XMLHttpRequest object. Used in the browser environment only. Defaults to false.
-
apiVersion
(String, Date)
—
a String in YYYY-MM-DD format (or a date) that represents the latest possible API version that can be used in all services (unless overridden by
apiVersions
). Specify 'latest' to use the latest possible version. -
apiVersions
(map<String, String|Date>)
—
a map of service identifiers (the lowercase service class name) with the API version to use when instantiating a service. Specify 'latest' for each individual that can use the latest available version.
-
logger
(#write, #log)
—
an object that responds to .write() (like a stream) or .log() (like the console object) in order to log information about requests
-
systemClockOffset
(Number)
—
an offset value in milliseconds to apply to all signing times. Use this to compensate for clock skew when your system may be out of sync with the service time. Note that this configuration option can only be applied to the global
AWS.config
object and cannot be overridden in service-specific configuration. Defaults to 0 milliseconds. -
signatureVersion
(String)
—
the signature version to sign requests with (overriding the API configuration). Possible values are: 'v2', 'v3', 'v4'.
-
signatureCache
(Boolean)
—
whether the signature to sign requests with (overriding the API configuration) is cached. Only applies to the signature version 'v4'. Defaults to
true
. -
dynamoDbCrc32
(Boolean)
—
whether to validate the CRC32 checksum of HTTP response bodies returned by DynamoDB. Default:
true
. -
useAccelerateEndpoint
(Boolean)
—
Whether to use the S3 Transfer Acceleration endpoint with the S3 service. Default:
false
. -
clientSideMonitoring
(Boolean)
—
whether to collect and publish this client's performance metrics of all its API requests.
-
endpointDiscoveryEnabled
(Boolean)
—
whether to enable endpoint discovery for operations that allow optionally using an endpoint returned by the service. Defaults to 'false'
-
endpointCacheSize
(Number)
—
the size of the global cache storing endpoints from endpoint discovery operations. Once endpoint cache is created, updating this setting cannot change existing cache size. Defaults to 1000
-
hostPrefixEnabled
(Boolean)
—
whether to marshal request parameters to the prefix of hostname. Defaults to
true
.
Property Details
Method Details
associateCertificate(params = {}, callback) ⇒ AWS.Request
Associates an AWS Certificate Manager (ACM) Amazon Resource Name (ARN) with AWS Elemental MediaConvert.
Service Reference:
Examples:
Calling the associateCertificate operation
var params = {
Arn: 'STRING_VALUE' /* required */
};
mediaconvert.associateCertificate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Arn
— (String
) The ARN of the ACM certificate that you want to associate with your MediaConvert resource.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
cancelJob(params = {}, callback) ⇒ AWS.Request
Permanently cancel a job. Once you have canceled a job, you can't start it again.
Service Reference:
Examples:
Calling the cancelJob operation
var params = {
Id: 'STRING_VALUE' /* required */
};
mediaconvert.cancelJob(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Id
— (String
) The Job ID of the job to be cancelled.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
createJob(params = {}, callback) ⇒ AWS.Request
Create a new transcoding job. For information about jobs and job settings, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html
Service Reference:
Examples:
Calling the createJob operation
var params = {
Role: 'STRING_VALUE', /* required */
Settings: { /* required */
AdAvailOffset: 'NUMBER_VALUE',
AvailBlanking: {
AvailBlankingImage: 'STRING_VALUE'
},
Esam: {
ManifestConfirmConditionNotification: {
MccXml: 'STRING_VALUE'
},
ResponseSignalPreroll: 'NUMBER_VALUE',
SignalProcessingNotification: {
SccXml: 'STRING_VALUE'
}
},
Inputs: [
{
AudioSelectorGroups: {
'<__string>': {
AudioSelectorNames: [
'STRING_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
AudioSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
DefaultSelection: DEFAULT | NOT_DEFAULT,
ExternalAudioFileInput: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
Offset: 'NUMBER_VALUE',
Pids: [
'NUMBER_VALUE',
/* more items */
],
ProgramSelection: 'NUMBER_VALUE',
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
SelectorType: PID | TRACK | LANGUAGE_CODE,
Tracks: [
'NUMBER_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
CaptionSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
SourceSettings: {
AncillarySourceSettings: {
SourceAncillaryChannelNumber: 'NUMBER_VALUE'
},
DvbSubSourceSettings: {
Pid: 'NUMBER_VALUE'
},
EmbeddedSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
Source608ChannelNumber: 'NUMBER_VALUE',
Source608TrackNumber: 'NUMBER_VALUE'
},
FileSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
SourceFile: 'STRING_VALUE',
TimeDelta: 'NUMBER_VALUE'
},
SourceType: ANCILLARY | DVB_SUB | EMBEDDED | SCTE20 | SCC | TTML | STL | SRT | SMI | TELETEXT | NULL_SOURCE | IMSC,
TeletextSourceSettings: {
PageNumber: 'STRING_VALUE'
},
TrackSourceSettings: {
TrackNumber: 'NUMBER_VALUE'
}
}
},
/* '<__string>': ... */
},
DeblockFilter: ENABLED | DISABLED,
DecryptionSettings: {
DecryptionMode: AES_CTR | AES_CBC | AES_GCM,
EncryptedDecryptionKey: 'STRING_VALUE',
InitializationVector: 'STRING_VALUE',
KmsKeyRegion: 'STRING_VALUE'
},
DenoiseFilter: ENABLED | DISABLED,
FileInput: 'STRING_VALUE',
FilterEnable: AUTO | DISABLE | FORCE,
FilterStrength: 'NUMBER_VALUE',
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
InputClippings: [
{
EndTimecode: 'STRING_VALUE',
StartTimecode: 'STRING_VALUE'
},
/* more items */
],
ProgramNumber: 'NUMBER_VALUE',
PsiControl: IGNORE_PSI | USE_PSI,
SupplementalImps: [
'STRING_VALUE',
/* more items */
],
TimecodeSource: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
VideoSelector: {
ColorSpace: FOLLOW | REC_601 | REC_709 | HDR10 | HLG_2020,
ColorSpaceUsage: FORCE | FALLBACK,
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Pid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Rotate: DEGREE_0 | DEGREES_90 | DEGREES_180 | DEGREES_270 | AUTO
}
},
/* more items */
],
MotionImageInserter: {
Framerate: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE'
},
Input: 'STRING_VALUE',
InsertionMode: MOV | PNG,
Offset: {
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE'
},
Playback: ONCE | REPEAT,
StartTime: 'STRING_VALUE'
},
NielsenConfiguration: {
BreakoutCode: 'NUMBER_VALUE',
DistributorId: 'STRING_VALUE'
},
OutputGroups: [
{
CustomName: 'STRING_VALUE',
Name: 'STRING_VALUE',
OutputGroupSettings: {
CmafGroupSettings: {
BaseUrl: 'STRING_VALUE',
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: STATIC_KEY
},
FragmentLength: 'NUMBER_VALUE',
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinBufferTime: 'NUMBER_VALUE',
MinFinalSegmentLength: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
WriteDashManifest: DISABLED | ENABLED,
WriteHlsManifest: DISABLED | ENABLED
},
DashIsoGroupSettings: {
BaseUrl: 'STRING_VALUE',
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
HbbtvCompliance: HBBTV_1_5 | NONE,
MinBufferTime: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
WriteSegmentTimelineInRepresentation: ENABLED | DISABLED
},
FileGroupSettings: {
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
}
},
HlsGroupSettings: {
AdMarkers: [
ELEMENTAL | ELEMENTAL_SCTE35,
/* more items */
],
BaseUrl: 'STRING_VALUE',
CaptionLanguageMappings: [
{
CaptionChannel: 'NUMBER_VALUE',
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
CaptionLanguageSetting: INSERT | OMIT | NONE,
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
DirectoryStructure: SINGLE_DIRECTORY | SUBDIRECTORY_PER_STREAM,
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: AES128 | SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
OfflineEncrypted: ENABLED | DISABLED,
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
},
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: SPEKE | STATIC_KEY
},
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinFinalSegmentLength: 'NUMBER_VALUE',
MinSegmentLength: 'NUMBER_VALUE',
OutputSelection: MANIFESTS_AND_SEGMENTS | SEGMENTS_ONLY,
ProgramDateTime: INCLUDE | EXCLUDE,
ProgramDateTimePeriod: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
SegmentsPerSubdirectory: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
TimedMetadataId3Frame: NONE | PRIV | TDRL,
TimedMetadataId3Period: 'NUMBER_VALUE',
TimestampDeltaMilliseconds: 'NUMBER_VALUE'
},
MsSmoothGroupSettings: {
AudioDeduplication: COMBINE_DUPLICATE_STREAMS | NONE,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
ManifestEncoding: UTF8 | UTF16
},
Type: HLS_GROUP_SETTINGS | DASH_ISO_GROUP_SETTINGS | FILE_GROUP_SETTINGS | MS_SMOOTH_GROUP_SETTINGS | CMAF_GROUP_SETTINGS
},
Outputs: [
{
AudioDescriptions: [
{
AudioNormalizationSettings: {
Algorithm: ITU_BS_1770_1 | ITU_BS_1770_2,
AlgorithmControl: CORRECT_AUDIO | MEASURE_ONLY,
CorrectionGateLevel: 'NUMBER_VALUE',
LoudnessLogging: LOG | DONT_LOG,
PeakCalculation: TRUE_PEAK | NONE,
TargetLkfs: 'NUMBER_VALUE'
},
AudioSourceName: 'STRING_VALUE',
AudioType: 'NUMBER_VALUE',
AudioTypeControl: FOLLOW_INPUT | USE_CONFIGURED,
CodecSettings: {
AacSettings: {
AudioDescriptionBroadcasterMix: BROADCASTER_MIXED_AD | NORMAL,
Bitrate: 'NUMBER_VALUE',
CodecProfile: LC | HEV1 | HEV2,
CodingMode: AD_RECEIVER_MIX | CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_5_1,
RateControlMode: CBR | VBR,
RawFormat: LATM_LOAS | NONE,
SampleRate: 'NUMBER_VALUE',
Specification: MPEG2 | MPEG4,
VbrQuality: LOW | MEDIUM_LOW | MEDIUM_HIGH | HIGH
},
Ac3Settings: {
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | DIALOGUE | EMERGENCY | HEARING_IMPAIRED | MUSIC_AND_EFFECTS | VISUALLY_IMPAIRED | VOICE_OVER,
CodingMode: CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_3_2_LFE,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionProfile: FILM_STANDARD | NONE,
LfeFilter: ENABLED | DISABLED,
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
SampleRate: 'NUMBER_VALUE'
},
AiffSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
Codec: AAC | MP2 | WAV | AIFF | AC3 | EAC3 | PASSTHROUGH,
Eac3Settings: {
AttenuationControl: ATTENUATE_3_DB | NONE,
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | EMERGENCY | HEARING_IMPAIRED | VISUALLY_IMPAIRED,
CodingMode: CODING_MODE_1_0 | CODING_MODE_2_0 | CODING_MODE_3_2,
DcFilter: ENABLED | DISABLED,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionLine: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
DynamicRangeCompressionRf: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
LfeControl: LFE | NO_LFE,
LfeFilter: ENABLED | DISABLED,
LoRoCenterMixLevel: 'NUMBER_VALUE',
LoRoSurroundMixLevel: 'NUMBER_VALUE',
LtRtCenterMixLevel: 'NUMBER_VALUE',
LtRtSurroundMixLevel: 'NUMBER_VALUE',
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
PassthroughControl: WHEN_POSSIBLE | NO_PASSTHROUGH,
PhaseControl: SHIFT_90_DEGREES | NO_SHIFT,
SampleRate: 'NUMBER_VALUE',
StereoDownmix: NOT_INDICATED | LO_RO | LT_RT | DPL2,
SurroundExMode: NOT_INDICATED | ENABLED | DISABLED,
SurroundMode: NOT_INDICATED | ENABLED | DISABLED
},
Mp2Settings: {
Bitrate: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
WavSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
Format: RIFF | RF64,
SampleRate: 'NUMBER_VALUE'
}
},
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageCodeControl: FOLLOW_INPUT | USE_CONFIGURED,
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
StreamName: 'STRING_VALUE'
},
/* more items */
],
CaptionDescriptions: [
{
CaptionSelectorName: 'STRING_VALUE',
CustomLanguageCode: 'STRING_VALUE',
DestinationSettings: {
BurninDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
DestinationType: BURN_IN | DVB_SUB | EMBEDDED | EMBEDDED_PLUS_SCTE20 | SCTE20_PLUS_EMBEDDED | SCC | SRT | SMI | TELETEXT | TTML | WEBVTT,
DvbSubDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
EmbeddedDestinationSettings: {
Destination608ChannelNumber: 'NUMBER_VALUE'
},
SccDestinationSettings: {
Framerate: FRAMERATE_23_97 | FRAMERATE_24 | FRAMERATE_29_97_DROPFRAME | FRAMERATE_29_97_NON_DROPFRAME
},
TeletextDestinationSettings: {
PageNumber: 'STRING_VALUE'
},
TtmlDestinationSettings: {
StylePassthrough: ENABLED | DISABLED
}
},
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
ContainerSettings: {
Container: F4V | ISMV | M2TS | M3U8 | CMFC | MOV | MP4 | MPD | MXF | RAW,
F4vSettings: {
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL
},
M2tsSettings: {
AudioBufferModel: DVB | ATSC,
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
Bitrate: 'NUMBER_VALUE',
BufferModel: MULTIPLEX | NONE,
DvbNitSettings: {
NetworkId: 'NUMBER_VALUE',
NetworkName: 'STRING_VALUE',
NitInterval: 'NUMBER_VALUE'
},
DvbSdtSettings: {
OutputSdt: SDT_FOLLOW | SDT_FOLLOW_IF_PRESENT | SDT_MANUAL | SDT_NONE,
SdtInterval: 'NUMBER_VALUE',
ServiceName: 'STRING_VALUE',
ServiceProviderName: 'STRING_VALUE'
},
DvbSubPids: [
'NUMBER_VALUE',
/* more items */
],
DvbTdtSettings: {
TdtInterval: 'NUMBER_VALUE'
},
DvbTeletextPid: 'NUMBER_VALUE',
EbpAudioInterval: VIDEO_AND_FIXED_INTERVALS | VIDEO_INTERVAL,
EbpPlacement: VIDEO_AND_AUDIO_PIDS | VIDEO_PID,
EsRateInPes: INCLUDE | EXCLUDE,
ForceTsVideoEbpOrder: FORCE | DEFAULT,
FragmentTime: 'NUMBER_VALUE',
MaxPcrInterval: 'NUMBER_VALUE',
MinEbpInterval: 'NUMBER_VALUE',
NielsenId3: INSERT | NONE,
NullPacketBitrate: 'NUMBER_VALUE',
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
RateMode: VBR | CBR,
Scte35Esam: {
Scte35EsamPid: 'NUMBER_VALUE'
},
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
SegmentationMarkers: NONE | RAI_SEGSTART | RAI_ADAPT | PSI_SEGSTART | EBP | EBP_LEGACY,
SegmentationStyle: MAINTAIN_CADENCE | RESET_CADENCE,
SegmentationTime: 'NUMBER_VALUE',
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
M3u8Settings: {
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
NielsenId3: INSERT | NONE,
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
TimedMetadata: PASSTHROUGH | NONE,
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
MovSettings: {
ClapAtom: INCLUDE | EXCLUDE,
CslgAtom: INCLUDE | EXCLUDE,
Mpeg2FourCCControl: XDCAM | MPEG,
PaddingControl: OMNEON | NONE,
Reference: SELF_CONTAINED | EXTERNAL
},
Mp4Settings: {
CslgAtom: INCLUDE | EXCLUDE,
FreeSpaceBox: INCLUDE | EXCLUDE,
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL,
Mp4MajorBrand: 'STRING_VALUE'
}
},
Extension: 'STRING_VALUE',
NameModifier: 'STRING_VALUE',
OutputSettings: {
HlsSettings: {
AudioGroupId: 'STRING_VALUE',
AudioRenditionSets: 'STRING_VALUE',
AudioTrackType: ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT | ALTERNATE_AUDIO_AUTO_SELECT | ALTERNATE_AUDIO_NOT_AUTO_SELECT | AUDIO_ONLY_VARIANT_STREAM,
IFrameOnlyManifest: INCLUDE | EXCLUDE,
SegmentModifier: 'STRING_VALUE'
}
},
Preset: 'STRING_VALUE',
VideoDescription: {
AfdSignaling: NONE | AUTO | FIXED,
AntiAlias: DISABLED | ENABLED,
CodecSettings: {
Codec: FRAME_CAPTURE | H_264 | H_265 | MPEG2 | PRORES,
FrameCaptureSettings: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
MaxCaptures: 'NUMBER_VALUE',
Quality: 'NUMBER_VALUE'
},
H264Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_1_1 | LEVEL_1_2 | LEVEL_1_3 | LEVEL_2 | LEVEL_2_1 | LEVEL_2_2 | LEVEL_3 | LEVEL_3_1 | LEVEL_3_2 | LEVEL_4 | LEVEL_4_1 | LEVEL_4_2 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2,
CodecProfile: BASELINE | HIGH | HIGH_10BIT | HIGH_422 | HIGH_422_10BIT | MAIN,
DynamicSubGop: ADAPTIVE | STATIC,
EntropyEncoding: CABAC | CAVLC,
FieldEncoding: PAFF | FORCE_FIELD,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
RepeatPps: DISABLED | ENABLED,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | RP2027,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED
},
H265Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
AlternateTransferFunctionSei: DISABLED | ENABLED,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_2 | LEVEL_2_1 | LEVEL_3 | LEVEL_3_1 | LEVEL_4 | LEVEL_4_1 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2 | LEVEL_6 | LEVEL_6_1 | LEVEL_6_2,
CodecProfile: MAIN_MAIN | MAIN_HIGH | MAIN10_MAIN | MAIN10_HIGH | MAIN_422_8BIT_MAIN | MAIN_422_8BIT_HIGH | MAIN_422_10BIT_MAIN | MAIN_422_10BIT_HIGH,
DynamicSubGop: ADAPTIVE | STATIC,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
SampleAdaptiveOffsetFilterMode: DEFAULT | ADAPTIVE | OFF,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
TemporalIds: DISABLED | ENABLED,
Tiles: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED,
WriteMp4PackagingType: HVC1 | HEV1
},
Mpeg2Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LOW | MAIN | HIGH1440 | HIGH,
CodecProfile: MAIN | PROFILE_422,
DynamicSubGop: ADAPTIVE | STATIC,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
IntraDcPrecision: AUTO | INTRA_DC_PRECISION_8 | INTRA_DC_PRECISION_9 | INTRA_DC_PRECISION_10 | INTRA_DC_PRECISION_11,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | MULTI_PASS,
RateControlMode: VBR | CBR,
SceneChangeDetect: DISABLED | ENABLED,
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | D_10,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED
},
ProresSettings: {
CodecProfile: APPLE_PRORES_422 | APPLE_PRORES_422_HQ | APPLE_PRORES_422_LT | APPLE_PRORES_422_PROXY,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Telecine: NONE | HARD
}
},
ColorMetadata: IGNORE | INSERT,
Crop: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
DropFrameTimecode: DISABLED | ENABLED,
FixedAfd: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
Position: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
RespondToAfd: NONE | RESPOND | PASSTHROUGH,
ScalingBehavior: DEFAULT | STRETCH_TO_OUTPUT,
Sharpness: 'NUMBER_VALUE',
TimecodeInsertion: DISABLED | PIC_TIMING_SEI,
VideoPreprocessors: {
ColorCorrector: {
Brightness: 'NUMBER_VALUE',
ColorSpaceConversion: NONE | FORCE_601 | FORCE_709 | FORCE_HDR10 | FORCE_HLG_2020,
Contrast: 'NUMBER_VALUE',
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Hue: 'NUMBER_VALUE',
Saturation: 'NUMBER_VALUE'
},
Deinterlacer: {
Algorithm: INTERPOLATE | INTERPOLATE_TICKER | BLEND | BLEND_TICKER,
Control: FORCE_ALL_FRAMES | NORMAL,
Mode: DEINTERLACE | INVERSE_TELECINE | ADAPTIVE
},
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
NoiseReducer: {
Filter: BILATERAL | MEAN | GAUSSIAN | LANCZOS | SHARPEN | CONSERVE | SPATIAL,
FilterSettings: {
Strength: 'NUMBER_VALUE'
},
SpatialFilterSettings: {
PostFilterSharpenStrength: 'NUMBER_VALUE',
Speed: 'NUMBER_VALUE',
Strength: 'NUMBER_VALUE'
}
},
TimecodeBurnin: {
FontSize: 'NUMBER_VALUE',
Position: TOP_CENTER | TOP_LEFT | TOP_RIGHT | MIDDLE_LEFT | MIDDLE_CENTER | MIDDLE_RIGHT | BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT,
Prefix: 'STRING_VALUE'
}
},
Width: 'NUMBER_VALUE'
}
},
/* more items */
]
},
/* more items */
],
TimecodeConfig: {
Anchor: 'STRING_VALUE',
Source: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
Start: 'STRING_VALUE',
TimestampOffset: 'STRING_VALUE'
},
TimedMetadataInsertion: {
Id3Insertions: [
{
Id3: 'STRING_VALUE',
Timecode: 'STRING_VALUE'
},
/* more items */
]
}
},
AccelerationSettings: {
Mode: DISABLED | ENABLED /* required */
},
BillingTagsSource: QUEUE | PRESET | JOB_TEMPLATE,
ClientRequestToken: 'STRING_VALUE',
JobTemplate: 'STRING_VALUE',
Queue: 'STRING_VALUE',
StatusUpdateInterval: SECONDS_10 | SECONDS_12 | SECONDS_15 | SECONDS_20 | SECONDS_30 | SECONDS_60 | SECONDS_120 | SECONDS_180 | SECONDS_240 | SECONDS_300 | SECONDS_360 | SECONDS_420 | SECONDS_480 | SECONDS_540 | SECONDS_600,
UserMetadata: {
'<__string>': 'STRING_VALUE',
/* '<__string>': ... */
}
};
mediaconvert.createJob(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
AccelerationSettings
— (map
) This is a beta feature. If you are interested in using this feature, please contact AWS customer support.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
BillingTagsSource
— (String
) Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted. Possible values include:"QUEUE"
"PRESET"
"JOB_TEMPLATE"
ClientRequestToken
— (String
) Idempotency token for CreateJob operation. If a token is not provided, the SDK will use a version 4 UUID.JobTemplate
— (String
) When you create a job, you can either specify a job template or specify the transcoding settings individuallyQueue
— (String
) Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html.Role
— (String
) Required. The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.html.Settings
— (map
) JobSettings contains all the transcode settings for a job.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DecryptionSettings
— (map
) Settings for decrypting any input files that you encrypt before you upload them to Amazon S3. MediaConvert can decrypt files only when you use AWS Key Management Service (KMS) to encrypt the data key that you use to encrypt your content.DecryptionMode
— (String
) Specify the encryption mode that you used to encrypt your input files. Possible values include:"AES_CTR"
"AES_CBC"
"AES_GCM"
EncryptedDecryptionKey
— (String
) Warning! Don't provide your encryption key in plaintext. Your job settings could be intercepted, making your encrypted content vulnerable. Specify the encrypted version of the data key that you used to encrypt your content. The data key must be encrypted by AWS Key Management Service (KMS). The key can be 128, 192, or 256 bits.InitializationVector
— (String
) Specify the initialization vector that you used when you encrypted your content before uploading it to Amazon S3. You can use a 16-byte initialization vector with any encryption mode. Or, you can use a 12-byte initialization vector with GCM or CTR. MediaConvert accepts only initialization vectors that are base64-encoded.KmsKeyRegion
— (String
) Specify the AWS Region for AWS Key Management Service (KMS) that you used to encrypt your data key, if that Region is different from the one you are using for AWS Elemental MediaConvert.
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FileInput
— (String
) Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. If your input format is IMF, specify your input by providing the path to your CPL. For example, "s3://bucket/vf/cpl.xml". If the CPL is in an incomplete IMP, make sure to use Supplemental IMPs (SupplementalImps) to specify any supplemental IMPs that contain assets referenced by the CPL.FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
SupplementalImps
— (Array<String>
) Provide a list of any necessary supplemental IMPs. You need supplemental IMPs if the CPL that you're using for your input is in an incomplete IMP. Specify either the supplemental IMP directories with a trailing slash or the ASSETMAP.xml files. For example ["s3://bucket/ov/", "s3://bucket/vf2/ASSETMAP.xml"]. You don't need to specify the IMP that contains your input CPL, because the service automatically detects it.TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
UserMetadata
— (map<String>
) User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Job
— (map
) Each job converts an input file into an output file or files. For more information, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.htmlAccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.BillingTagsSource
— (String
) Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted. Possible values include:"QUEUE"
"PRESET"
"JOB_TEMPLATE"
CreatedAt
— (Date
) The time, in Unix epoch format in seconds, when the job got created.CurrentPhase
— (String
) A job's phase can be PROBING, TRANSCODING OR UPLOADING Possible values include:"PROBING"
"TRANSCODING"
"UPLOADING"
ErrorCode
— (Integer
) Error code for the jobErrorMessage
— (String
) Error message of JobId
— (String
) A portion of the job's ARN, unique within your AWS Elemental MediaConvert resourcesJobPercentComplete
— (Integer
) An estimate of how far your job has progressed. This estimate is shown as a percentage of the total time from when your job leaves its queue to when your output files appear in your output Amazon S3 bucket. AWS Elemental MediaConvert provides jobPercentComplete in CloudWatch STATUS_UPDATE events and in the response to GetJob and ListJobs requests. The jobPercentComplete estimate is reliable for the following input containers: Quicktime, Transport Stream, MP4, and MXF. For some jobs, including audio-only jobs and jobs that use input clipping, the service can't provide information about job progress. In those cases, jobPercentComplete returns a null value.JobTemplate
— (String
) The job template that the job is created from, if it is created from a job template.OutputGroupDetails
— (Array<map>
) List of output group detailsOutputDetails
— (Array<map>
) Details about the outputDurationInMs
— (Integer
) Duration in millisecondsVideoDetails
— (map
) Contains details about the output's video streamHeightInPx
— (Integer
) Height in pixels for the outputWidthInPx
— (Integer
) Width in pixels for the output
Queue
— (String
) Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.htmlRetryCount
— (Integer
) The number of times that the service automatically attempted to process your job after encountering an error.Role
— required — (String
) The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.htmlSettings
— required — (map
) JobSettings contains all the transcode settings for a job.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DecryptionSettings
— (map
) Settings for decrypting any input files that you encrypt before you upload them to Amazon S3. MediaConvert can decrypt files only when you use AWS Key Management Service (KMS) to encrypt the data key that you use to encrypt your content.DecryptionMode
— (String
) Specify the encryption mode that you used to encrypt your input files. Possible values include:"AES_CTR"
"AES_CBC"
"AES_GCM"
EncryptedDecryptionKey
— (String
) Warning! Don't provide your encryption key in plaintext. Your job settings could be intercepted, making your encrypted content vulnerable. Specify the encrypted version of the data key that you used to encrypt your content. The data key must be encrypted by AWS Key Management Service (KMS). The key can be 128, 192, or 256 bits.InitializationVector
— (String
) Specify the initialization vector that you used when you encrypted your content before uploading it to Amazon S3. You can use a 16-byte initialization vector with any encryption mode. Or, you can use a 12-byte initialization vector with GCM or CTR. MediaConvert accepts only initialization vectors that are base64-encoded.KmsKeyRegion
— (String
) Specify the AWS Region for AWS Key Management Service (KMS) that you used to encrypt your data key, if that Region is different from the one you are using for AWS Elemental MediaConvert.
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FileInput
— (String
) Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. If your input format is IMF, specify your input by providing the path to your CPL. For example, "s3://bucket/vf/cpl.xml". If the CPL is in an incomplete IMP, make sure to use Supplemental IMPs (SupplementalImps) to specify any supplemental IMPs that contain assets referenced by the CPL.FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
SupplementalImps
— (Array<String>
) Provide a list of any necessary supplemental IMPs. You need supplemental IMPs if the CPL that you're using for your input is in an incomplete IMP. Specify either the supplemental IMP directories with a trailing slash or the ASSETMAP.xml files. For example ["s3://bucket/ov/", "s3://bucket/vf2/ASSETMAP.xml"]. You don't need to specify the IMP that contains your input CPL, because the service automatically detects it.TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
Status
— (String
) A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR. Possible values include:"SUBMITTED"
"PROGRESSING"
"COMPLETE"
"CANCELED"
"ERROR"
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Timing
— (map
) Information about when jobs are submitted, started, and finished is specified in Unix epoch format in seconds.FinishTime
— (Date
) The time, in Unix epoch format, that the transcoding job finishedStartTime
— (Date
) The time, in Unix epoch format, that transcoding for the job began.SubmitTime
— (Date
) The time, in Unix epoch format, that you submitted the job.
UserMetadata
— (map<String>
) User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs.
-
(AWS.Response)
—
Returns:
createJobTemplate(params = {}, callback) ⇒ AWS.Request
Create a new job template. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html
Service Reference:
Examples:
Calling the createJobTemplate operation
var params = {
Name: 'STRING_VALUE', /* required */
Settings: { /* required */
AdAvailOffset: 'NUMBER_VALUE',
AvailBlanking: {
AvailBlankingImage: 'STRING_VALUE'
},
Esam: {
ManifestConfirmConditionNotification: {
MccXml: 'STRING_VALUE'
},
ResponseSignalPreroll: 'NUMBER_VALUE',
SignalProcessingNotification: {
SccXml: 'STRING_VALUE'
}
},
Inputs: [
{
AudioSelectorGroups: {
'<__string>': {
AudioSelectorNames: [
'STRING_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
AudioSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
DefaultSelection: DEFAULT | NOT_DEFAULT,
ExternalAudioFileInput: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
Offset: 'NUMBER_VALUE',
Pids: [
'NUMBER_VALUE',
/* more items */
],
ProgramSelection: 'NUMBER_VALUE',
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
SelectorType: PID | TRACK | LANGUAGE_CODE,
Tracks: [
'NUMBER_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
CaptionSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
SourceSettings: {
AncillarySourceSettings: {
SourceAncillaryChannelNumber: 'NUMBER_VALUE'
},
DvbSubSourceSettings: {
Pid: 'NUMBER_VALUE'
},
EmbeddedSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
Source608ChannelNumber: 'NUMBER_VALUE',
Source608TrackNumber: 'NUMBER_VALUE'
},
FileSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
SourceFile: 'STRING_VALUE',
TimeDelta: 'NUMBER_VALUE'
},
SourceType: ANCILLARY | DVB_SUB | EMBEDDED | SCTE20 | SCC | TTML | STL | SRT | SMI | TELETEXT | NULL_SOURCE | IMSC,
TeletextSourceSettings: {
PageNumber: 'STRING_VALUE'
},
TrackSourceSettings: {
TrackNumber: 'NUMBER_VALUE'
}
}
},
/* '<__string>': ... */
},
DeblockFilter: ENABLED | DISABLED,
DenoiseFilter: ENABLED | DISABLED,
FilterEnable: AUTO | DISABLE | FORCE,
FilterStrength: 'NUMBER_VALUE',
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
InputClippings: [
{
EndTimecode: 'STRING_VALUE',
StartTimecode: 'STRING_VALUE'
},
/* more items */
],
ProgramNumber: 'NUMBER_VALUE',
PsiControl: IGNORE_PSI | USE_PSI,
TimecodeSource: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
VideoSelector: {
ColorSpace: FOLLOW | REC_601 | REC_709 | HDR10 | HLG_2020,
ColorSpaceUsage: FORCE | FALLBACK,
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Pid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Rotate: DEGREE_0 | DEGREES_90 | DEGREES_180 | DEGREES_270 | AUTO
}
},
/* more items */
],
MotionImageInserter: {
Framerate: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE'
},
Input: 'STRING_VALUE',
InsertionMode: MOV | PNG,
Offset: {
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE'
},
Playback: ONCE | REPEAT,
StartTime: 'STRING_VALUE'
},
NielsenConfiguration: {
BreakoutCode: 'NUMBER_VALUE',
DistributorId: 'STRING_VALUE'
},
OutputGroups: [
{
CustomName: 'STRING_VALUE',
Name: 'STRING_VALUE',
OutputGroupSettings: {
CmafGroupSettings: {
BaseUrl: 'STRING_VALUE',
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: STATIC_KEY
},
FragmentLength: 'NUMBER_VALUE',
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinBufferTime: 'NUMBER_VALUE',
MinFinalSegmentLength: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
WriteDashManifest: DISABLED | ENABLED,
WriteHlsManifest: DISABLED | ENABLED
},
DashIsoGroupSettings: {
BaseUrl: 'STRING_VALUE',
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
HbbtvCompliance: HBBTV_1_5 | NONE,
MinBufferTime: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
WriteSegmentTimelineInRepresentation: ENABLED | DISABLED
},
FileGroupSettings: {
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
}
},
HlsGroupSettings: {
AdMarkers: [
ELEMENTAL | ELEMENTAL_SCTE35,
/* more items */
],
BaseUrl: 'STRING_VALUE',
CaptionLanguageMappings: [
{
CaptionChannel: 'NUMBER_VALUE',
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
CaptionLanguageSetting: INSERT | OMIT | NONE,
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
DirectoryStructure: SINGLE_DIRECTORY | SUBDIRECTORY_PER_STREAM,
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: AES128 | SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
OfflineEncrypted: ENABLED | DISABLED,
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
},
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: SPEKE | STATIC_KEY
},
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinFinalSegmentLength: 'NUMBER_VALUE',
MinSegmentLength: 'NUMBER_VALUE',
OutputSelection: MANIFESTS_AND_SEGMENTS | SEGMENTS_ONLY,
ProgramDateTime: INCLUDE | EXCLUDE,
ProgramDateTimePeriod: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
SegmentsPerSubdirectory: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
TimedMetadataId3Frame: NONE | PRIV | TDRL,
TimedMetadataId3Period: 'NUMBER_VALUE',
TimestampDeltaMilliseconds: 'NUMBER_VALUE'
},
MsSmoothGroupSettings: {
AudioDeduplication: COMBINE_DUPLICATE_STREAMS | NONE,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
ManifestEncoding: UTF8 | UTF16
},
Type: HLS_GROUP_SETTINGS | DASH_ISO_GROUP_SETTINGS | FILE_GROUP_SETTINGS | MS_SMOOTH_GROUP_SETTINGS | CMAF_GROUP_SETTINGS
},
Outputs: [
{
AudioDescriptions: [
{
AudioNormalizationSettings: {
Algorithm: ITU_BS_1770_1 | ITU_BS_1770_2,
AlgorithmControl: CORRECT_AUDIO | MEASURE_ONLY,
CorrectionGateLevel: 'NUMBER_VALUE',
LoudnessLogging: LOG | DONT_LOG,
PeakCalculation: TRUE_PEAK | NONE,
TargetLkfs: 'NUMBER_VALUE'
},
AudioSourceName: 'STRING_VALUE',
AudioType: 'NUMBER_VALUE',
AudioTypeControl: FOLLOW_INPUT | USE_CONFIGURED,
CodecSettings: {
AacSettings: {
AudioDescriptionBroadcasterMix: BROADCASTER_MIXED_AD | NORMAL,
Bitrate: 'NUMBER_VALUE',
CodecProfile: LC | HEV1 | HEV2,
CodingMode: AD_RECEIVER_MIX | CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_5_1,
RateControlMode: CBR | VBR,
RawFormat: LATM_LOAS | NONE,
SampleRate: 'NUMBER_VALUE',
Specification: MPEG2 | MPEG4,
VbrQuality: LOW | MEDIUM_LOW | MEDIUM_HIGH | HIGH
},
Ac3Settings: {
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | DIALOGUE | EMERGENCY | HEARING_IMPAIRED | MUSIC_AND_EFFECTS | VISUALLY_IMPAIRED | VOICE_OVER,
CodingMode: CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_3_2_LFE,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionProfile: FILM_STANDARD | NONE,
LfeFilter: ENABLED | DISABLED,
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
SampleRate: 'NUMBER_VALUE'
},
AiffSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
Codec: AAC | MP2 | WAV | AIFF | AC3 | EAC3 | PASSTHROUGH,
Eac3Settings: {
AttenuationControl: ATTENUATE_3_DB | NONE,
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | EMERGENCY | HEARING_IMPAIRED | VISUALLY_IMPAIRED,
CodingMode: CODING_MODE_1_0 | CODING_MODE_2_0 | CODING_MODE_3_2,
DcFilter: ENABLED | DISABLED,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionLine: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
DynamicRangeCompressionRf: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
LfeControl: LFE | NO_LFE,
LfeFilter: ENABLED | DISABLED,
LoRoCenterMixLevel: 'NUMBER_VALUE',
LoRoSurroundMixLevel: 'NUMBER_VALUE',
LtRtCenterMixLevel: 'NUMBER_VALUE',
LtRtSurroundMixLevel: 'NUMBER_VALUE',
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
PassthroughControl: WHEN_POSSIBLE | NO_PASSTHROUGH,
PhaseControl: SHIFT_90_DEGREES | NO_SHIFT,
SampleRate: 'NUMBER_VALUE',
StereoDownmix: NOT_INDICATED | LO_RO | LT_RT | DPL2,
SurroundExMode: NOT_INDICATED | ENABLED | DISABLED,
SurroundMode: NOT_INDICATED | ENABLED | DISABLED
},
Mp2Settings: {
Bitrate: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
WavSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
Format: RIFF | RF64,
SampleRate: 'NUMBER_VALUE'
}
},
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageCodeControl: FOLLOW_INPUT | USE_CONFIGURED,
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
StreamName: 'STRING_VALUE'
},
/* more items */
],
CaptionDescriptions: [
{
CaptionSelectorName: 'STRING_VALUE',
CustomLanguageCode: 'STRING_VALUE',
DestinationSettings: {
BurninDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
DestinationType: BURN_IN | DVB_SUB | EMBEDDED | EMBEDDED_PLUS_SCTE20 | SCTE20_PLUS_EMBEDDED | SCC | SRT | SMI | TELETEXT | TTML | WEBVTT,
DvbSubDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
EmbeddedDestinationSettings: {
Destination608ChannelNumber: 'NUMBER_VALUE'
},
SccDestinationSettings: {
Framerate: FRAMERATE_23_97 | FRAMERATE_24 | FRAMERATE_29_97_DROPFRAME | FRAMERATE_29_97_NON_DROPFRAME
},
TeletextDestinationSettings: {
PageNumber: 'STRING_VALUE'
},
TtmlDestinationSettings: {
StylePassthrough: ENABLED | DISABLED
}
},
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
ContainerSettings: {
Container: F4V | ISMV | M2TS | M3U8 | CMFC | MOV | MP4 | MPD | MXF | RAW,
F4vSettings: {
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL
},
M2tsSettings: {
AudioBufferModel: DVB | ATSC,
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
Bitrate: 'NUMBER_VALUE',
BufferModel: MULTIPLEX | NONE,
DvbNitSettings: {
NetworkId: 'NUMBER_VALUE',
NetworkName: 'STRING_VALUE',
NitInterval: 'NUMBER_VALUE'
},
DvbSdtSettings: {
OutputSdt: SDT_FOLLOW | SDT_FOLLOW_IF_PRESENT | SDT_MANUAL | SDT_NONE,
SdtInterval: 'NUMBER_VALUE',
ServiceName: 'STRING_VALUE',
ServiceProviderName: 'STRING_VALUE'
},
DvbSubPids: [
'NUMBER_VALUE',
/* more items */
],
DvbTdtSettings: {
TdtInterval: 'NUMBER_VALUE'
},
DvbTeletextPid: 'NUMBER_VALUE',
EbpAudioInterval: VIDEO_AND_FIXED_INTERVALS | VIDEO_INTERVAL,
EbpPlacement: VIDEO_AND_AUDIO_PIDS | VIDEO_PID,
EsRateInPes: INCLUDE | EXCLUDE,
ForceTsVideoEbpOrder: FORCE | DEFAULT,
FragmentTime: 'NUMBER_VALUE',
MaxPcrInterval: 'NUMBER_VALUE',
MinEbpInterval: 'NUMBER_VALUE',
NielsenId3: INSERT | NONE,
NullPacketBitrate: 'NUMBER_VALUE',
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
RateMode: VBR | CBR,
Scte35Esam: {
Scte35EsamPid: 'NUMBER_VALUE'
},
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
SegmentationMarkers: NONE | RAI_SEGSTART | RAI_ADAPT | PSI_SEGSTART | EBP | EBP_LEGACY,
SegmentationStyle: MAINTAIN_CADENCE | RESET_CADENCE,
SegmentationTime: 'NUMBER_VALUE',
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
M3u8Settings: {
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
NielsenId3: INSERT | NONE,
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
TimedMetadata: PASSTHROUGH | NONE,
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
MovSettings: {
ClapAtom: INCLUDE | EXCLUDE,
CslgAtom: INCLUDE | EXCLUDE,
Mpeg2FourCCControl: XDCAM | MPEG,
PaddingControl: OMNEON | NONE,
Reference: SELF_CONTAINED | EXTERNAL
},
Mp4Settings: {
CslgAtom: INCLUDE | EXCLUDE,
FreeSpaceBox: INCLUDE | EXCLUDE,
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL,
Mp4MajorBrand: 'STRING_VALUE'
}
},
Extension: 'STRING_VALUE',
NameModifier: 'STRING_VALUE',
OutputSettings: {
HlsSettings: {
AudioGroupId: 'STRING_VALUE',
AudioRenditionSets: 'STRING_VALUE',
AudioTrackType: ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT | ALTERNATE_AUDIO_AUTO_SELECT | ALTERNATE_AUDIO_NOT_AUTO_SELECT | AUDIO_ONLY_VARIANT_STREAM,
IFrameOnlyManifest: INCLUDE | EXCLUDE,
SegmentModifier: 'STRING_VALUE'
}
},
Preset: 'STRING_VALUE',
VideoDescription: {
AfdSignaling: NONE | AUTO | FIXED,
AntiAlias: DISABLED | ENABLED,
CodecSettings: {
Codec: FRAME_CAPTURE | H_264 | H_265 | MPEG2 | PRORES,
FrameCaptureSettings: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
MaxCaptures: 'NUMBER_VALUE',
Quality: 'NUMBER_VALUE'
},
H264Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_1_1 | LEVEL_1_2 | LEVEL_1_3 | LEVEL_2 | LEVEL_2_1 | LEVEL_2_2 | LEVEL_3 | LEVEL_3_1 | LEVEL_3_2 | LEVEL_4 | LEVEL_4_1 | LEVEL_4_2 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2,
CodecProfile: BASELINE | HIGH | HIGH_10BIT | HIGH_422 | HIGH_422_10BIT | MAIN,
DynamicSubGop: ADAPTIVE | STATIC,
EntropyEncoding: CABAC | CAVLC,
FieldEncoding: PAFF | FORCE_FIELD,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
RepeatPps: DISABLED | ENABLED,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | RP2027,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED
},
H265Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
AlternateTransferFunctionSei: DISABLED | ENABLED,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_2 | LEVEL_2_1 | LEVEL_3 | LEVEL_3_1 | LEVEL_4 | LEVEL_4_1 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2 | LEVEL_6 | LEVEL_6_1 | LEVEL_6_2,
CodecProfile: MAIN_MAIN | MAIN_HIGH | MAIN10_MAIN | MAIN10_HIGH | MAIN_422_8BIT_MAIN | MAIN_422_8BIT_HIGH | MAIN_422_10BIT_MAIN | MAIN_422_10BIT_HIGH,
DynamicSubGop: ADAPTIVE | STATIC,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
SampleAdaptiveOffsetFilterMode: DEFAULT | ADAPTIVE | OFF,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
TemporalIds: DISABLED | ENABLED,
Tiles: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED,
WriteMp4PackagingType: HVC1 | HEV1
},
Mpeg2Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LOW | MAIN | HIGH1440 | HIGH,
CodecProfile: MAIN | PROFILE_422,
DynamicSubGop: ADAPTIVE | STATIC,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
IntraDcPrecision: AUTO | INTRA_DC_PRECISION_8 | INTRA_DC_PRECISION_9 | INTRA_DC_PRECISION_10 | INTRA_DC_PRECISION_11,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | MULTI_PASS,
RateControlMode: VBR | CBR,
SceneChangeDetect: DISABLED | ENABLED,
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | D_10,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED
},
ProresSettings: {
CodecProfile: APPLE_PRORES_422 | APPLE_PRORES_422_HQ | APPLE_PRORES_422_LT | APPLE_PRORES_422_PROXY,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Telecine: NONE | HARD
}
},
ColorMetadata: IGNORE | INSERT,
Crop: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
DropFrameTimecode: DISABLED | ENABLED,
FixedAfd: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
Position: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
RespondToAfd: NONE | RESPOND | PASSTHROUGH,
ScalingBehavior: DEFAULT | STRETCH_TO_OUTPUT,
Sharpness: 'NUMBER_VALUE',
TimecodeInsertion: DISABLED | PIC_TIMING_SEI,
VideoPreprocessors: {
ColorCorrector: {
Brightness: 'NUMBER_VALUE',
ColorSpaceConversion: NONE | FORCE_601 | FORCE_709 | FORCE_HDR10 | FORCE_HLG_2020,
Contrast: 'NUMBER_VALUE',
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Hue: 'NUMBER_VALUE',
Saturation: 'NUMBER_VALUE'
},
Deinterlacer: {
Algorithm: INTERPOLATE | INTERPOLATE_TICKER | BLEND | BLEND_TICKER,
Control: FORCE_ALL_FRAMES | NORMAL,
Mode: DEINTERLACE | INVERSE_TELECINE | ADAPTIVE
},
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
NoiseReducer: {
Filter: BILATERAL | MEAN | GAUSSIAN | LANCZOS | SHARPEN | CONSERVE | SPATIAL,
FilterSettings: {
Strength: 'NUMBER_VALUE'
},
SpatialFilterSettings: {
PostFilterSharpenStrength: 'NUMBER_VALUE',
Speed: 'NUMBER_VALUE',
Strength: 'NUMBER_VALUE'
}
},
TimecodeBurnin: {
FontSize: 'NUMBER_VALUE',
Position: TOP_CENTER | TOP_LEFT | TOP_RIGHT | MIDDLE_LEFT | MIDDLE_CENTER | MIDDLE_RIGHT | BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT,
Prefix: 'STRING_VALUE'
}
},
Width: 'NUMBER_VALUE'
}
},
/* more items */
]
},
/* more items */
],
TimecodeConfig: {
Anchor: 'STRING_VALUE',
Source: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
Start: 'STRING_VALUE',
TimestampOffset: 'STRING_VALUE'
},
TimedMetadataInsertion: {
Id3Insertions: [
{
Id3: 'STRING_VALUE',
Timecode: 'STRING_VALUE'
},
/* more items */
]
}
},
AccelerationSettings: {
Mode: DISABLED | ENABLED /* required */
},
Category: 'STRING_VALUE',
Description: 'STRING_VALUE',
Queue: 'STRING_VALUE',
StatusUpdateInterval: SECONDS_10 | SECONDS_12 | SECONDS_15 | SECONDS_20 | SECONDS_30 | SECONDS_60 | SECONDS_120 | SECONDS_180 | SECONDS_240 | SECONDS_300 | SECONDS_360 | SECONDS_420 | SECONDS_480 | SECONDS_540 | SECONDS_600,
Tags: {
'<__string>': 'STRING_VALUE',
/* '<__string>': ... */
}
};
mediaconvert.createJobTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
AccelerationSettings
— (map
) This is a beta feature. If you are interested in using this feature please contact AWS customer support.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Category
— (String
) Optional. A category for the job template you are creatingDescription
— (String
) Optional. A description of the job template you are creating.Name
— (String
) The name of the job template you are creating.Queue
— (String
) Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue.Settings
— (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Tags
— (map<String>
) The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:JobTemplate
— (map
) A job template is a pre-made set of encoding instructions that you can use to quickly create a job.AccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your job templates.CreatedAt
— (Date
) The timestamp in epoch seconds for Job template creation.Description
— (String
) An optional description you create for each job template.LastUpdated
— (Date
) The timestamp in epoch seconds when the Job template was last updated.Name
— required — (String
) A name you create for each job template. Each name must be unique within your account.Queue
— (String
) Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue.Settings
— required — (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Type
— (String
) A job template can be of two types: system or custom. System or built-in job templates can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
createPreset(params = {}, callback) ⇒ AWS.Request
Create a new preset. For information about job templates see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.html
Service Reference:
Examples:
Calling the createPreset operation
var params = {
Name: 'STRING_VALUE', /* required */
Settings: { /* required */
AudioDescriptions: [
{
AudioNormalizationSettings: {
Algorithm: ITU_BS_1770_1 | ITU_BS_1770_2,
AlgorithmControl: CORRECT_AUDIO | MEASURE_ONLY,
CorrectionGateLevel: 'NUMBER_VALUE',
LoudnessLogging: LOG | DONT_LOG,
PeakCalculation: TRUE_PEAK | NONE,
TargetLkfs: 'NUMBER_VALUE'
},
AudioSourceName: 'STRING_VALUE',
AudioType: 'NUMBER_VALUE',
AudioTypeControl: FOLLOW_INPUT | USE_CONFIGURED,
CodecSettings: {
AacSettings: {
AudioDescriptionBroadcasterMix: BROADCASTER_MIXED_AD | NORMAL,
Bitrate: 'NUMBER_VALUE',
CodecProfile: LC | HEV1 | HEV2,
CodingMode: AD_RECEIVER_MIX | CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_5_1,
RateControlMode: CBR | VBR,
RawFormat: LATM_LOAS | NONE,
SampleRate: 'NUMBER_VALUE',
Specification: MPEG2 | MPEG4,
VbrQuality: LOW | MEDIUM_LOW | MEDIUM_HIGH | HIGH
},
Ac3Settings: {
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | DIALOGUE | EMERGENCY | HEARING_IMPAIRED | MUSIC_AND_EFFECTS | VISUALLY_IMPAIRED | VOICE_OVER,
CodingMode: CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_3_2_LFE,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionProfile: FILM_STANDARD | NONE,
LfeFilter: ENABLED | DISABLED,
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
SampleRate: 'NUMBER_VALUE'
},
AiffSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
Codec: AAC | MP2 | WAV | AIFF | AC3 | EAC3 | PASSTHROUGH,
Eac3Settings: {
AttenuationControl: ATTENUATE_3_DB | NONE,
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | EMERGENCY | HEARING_IMPAIRED | VISUALLY_IMPAIRED,
CodingMode: CODING_MODE_1_0 | CODING_MODE_2_0 | CODING_MODE_3_2,
DcFilter: ENABLED | DISABLED,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionLine: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
DynamicRangeCompressionRf: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
LfeControl: LFE | NO_LFE,
LfeFilter: ENABLED | DISABLED,
LoRoCenterMixLevel: 'NUMBER_VALUE',
LoRoSurroundMixLevel: 'NUMBER_VALUE',
LtRtCenterMixLevel: 'NUMBER_VALUE',
LtRtSurroundMixLevel: 'NUMBER_VALUE',
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
PassthroughControl: WHEN_POSSIBLE | NO_PASSTHROUGH,
PhaseControl: SHIFT_90_DEGREES | NO_SHIFT,
SampleRate: 'NUMBER_VALUE',
StereoDownmix: NOT_INDICATED | LO_RO | LT_RT | DPL2,
SurroundExMode: NOT_INDICATED | ENABLED | DISABLED,
SurroundMode: NOT_INDICATED | ENABLED | DISABLED
},
Mp2Settings: {
Bitrate: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
WavSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
Format: RIFF | RF64,
SampleRate: 'NUMBER_VALUE'
}
},
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageCodeControl: FOLLOW_INPUT | USE_CONFIGURED,
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
StreamName: 'STRING_VALUE'
},
/* more items */
],
CaptionDescriptions: [
{
CustomLanguageCode: 'STRING_VALUE',
DestinationSettings: {
BurninDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
DestinationType: BURN_IN | DVB_SUB | EMBEDDED | EMBEDDED_PLUS_SCTE20 | SCTE20_PLUS_EMBEDDED | SCC | SRT | SMI | TELETEXT | TTML | WEBVTT,
DvbSubDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
EmbeddedDestinationSettings: {
Destination608ChannelNumber: 'NUMBER_VALUE'
},
SccDestinationSettings: {
Framerate: FRAMERATE_23_97 | FRAMERATE_24 | FRAMERATE_29_97_DROPFRAME | FRAMERATE_29_97_NON_DROPFRAME
},
TeletextDestinationSettings: {
PageNumber: 'STRING_VALUE'
},
TtmlDestinationSettings: {
StylePassthrough: ENABLED | DISABLED
}
},
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
ContainerSettings: {
Container: F4V | ISMV | M2TS | M3U8 | CMFC | MOV | MP4 | MPD | MXF | RAW,
F4vSettings: {
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL
},
M2tsSettings: {
AudioBufferModel: DVB | ATSC,
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
Bitrate: 'NUMBER_VALUE',
BufferModel: MULTIPLEX | NONE,
DvbNitSettings: {
NetworkId: 'NUMBER_VALUE',
NetworkName: 'STRING_VALUE',
NitInterval: 'NUMBER_VALUE'
},
DvbSdtSettings: {
OutputSdt: SDT_FOLLOW | SDT_FOLLOW_IF_PRESENT | SDT_MANUAL | SDT_NONE,
SdtInterval: 'NUMBER_VALUE',
ServiceName: 'STRING_VALUE',
ServiceProviderName: 'STRING_VALUE'
},
DvbSubPids: [
'NUMBER_VALUE',
/* more items */
],
DvbTdtSettings: {
TdtInterval: 'NUMBER_VALUE'
},
DvbTeletextPid: 'NUMBER_VALUE',
EbpAudioInterval: VIDEO_AND_FIXED_INTERVALS | VIDEO_INTERVAL,
EbpPlacement: VIDEO_AND_AUDIO_PIDS | VIDEO_PID,
EsRateInPes: INCLUDE | EXCLUDE,
ForceTsVideoEbpOrder: FORCE | DEFAULT,
FragmentTime: 'NUMBER_VALUE',
MaxPcrInterval: 'NUMBER_VALUE',
MinEbpInterval: 'NUMBER_VALUE',
NielsenId3: INSERT | NONE,
NullPacketBitrate: 'NUMBER_VALUE',
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
RateMode: VBR | CBR,
Scte35Esam: {
Scte35EsamPid: 'NUMBER_VALUE'
},
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
SegmentationMarkers: NONE | RAI_SEGSTART | RAI_ADAPT | PSI_SEGSTART | EBP | EBP_LEGACY,
SegmentationStyle: MAINTAIN_CADENCE | RESET_CADENCE,
SegmentationTime: 'NUMBER_VALUE',
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
M3u8Settings: {
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
NielsenId3: INSERT | NONE,
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
TimedMetadata: PASSTHROUGH | NONE,
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
MovSettings: {
ClapAtom: INCLUDE | EXCLUDE,
CslgAtom: INCLUDE | EXCLUDE,
Mpeg2FourCCControl: XDCAM | MPEG,
PaddingControl: OMNEON | NONE,
Reference: SELF_CONTAINED | EXTERNAL
},
Mp4Settings: {
CslgAtom: INCLUDE | EXCLUDE,
FreeSpaceBox: INCLUDE | EXCLUDE,
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL,
Mp4MajorBrand: 'STRING_VALUE'
}
},
VideoDescription: {
AfdSignaling: NONE | AUTO | FIXED,
AntiAlias: DISABLED | ENABLED,
CodecSettings: {
Codec: FRAME_CAPTURE | H_264 | H_265 | MPEG2 | PRORES,
FrameCaptureSettings: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
MaxCaptures: 'NUMBER_VALUE',
Quality: 'NUMBER_VALUE'
},
H264Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_1_1 | LEVEL_1_2 | LEVEL_1_3 | LEVEL_2 | LEVEL_2_1 | LEVEL_2_2 | LEVEL_3 | LEVEL_3_1 | LEVEL_3_2 | LEVEL_4 | LEVEL_4_1 | LEVEL_4_2 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2,
CodecProfile: BASELINE | HIGH | HIGH_10BIT | HIGH_422 | HIGH_422_10BIT | MAIN,
DynamicSubGop: ADAPTIVE | STATIC,
EntropyEncoding: CABAC | CAVLC,
FieldEncoding: PAFF | FORCE_FIELD,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
RepeatPps: DISABLED | ENABLED,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | RP2027,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED
},
H265Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
AlternateTransferFunctionSei: DISABLED | ENABLED,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_2 | LEVEL_2_1 | LEVEL_3 | LEVEL_3_1 | LEVEL_4 | LEVEL_4_1 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2 | LEVEL_6 | LEVEL_6_1 | LEVEL_6_2,
CodecProfile: MAIN_MAIN | MAIN_HIGH | MAIN10_MAIN | MAIN10_HIGH | MAIN_422_8BIT_MAIN | MAIN_422_8BIT_HIGH | MAIN_422_10BIT_MAIN | MAIN_422_10BIT_HIGH,
DynamicSubGop: ADAPTIVE | STATIC,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
SampleAdaptiveOffsetFilterMode: DEFAULT | ADAPTIVE | OFF,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
TemporalIds: DISABLED | ENABLED,
Tiles: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED,
WriteMp4PackagingType: HVC1 | HEV1
},
Mpeg2Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LOW | MAIN | HIGH1440 | HIGH,
CodecProfile: MAIN | PROFILE_422,
DynamicSubGop: ADAPTIVE | STATIC,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
IntraDcPrecision: AUTO | INTRA_DC_PRECISION_8 | INTRA_DC_PRECISION_9 | INTRA_DC_PRECISION_10 | INTRA_DC_PRECISION_11,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | MULTI_PASS,
RateControlMode: VBR | CBR,
SceneChangeDetect: DISABLED | ENABLED,
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | D_10,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED
},
ProresSettings: {
CodecProfile: APPLE_PRORES_422 | APPLE_PRORES_422_HQ | APPLE_PRORES_422_LT | APPLE_PRORES_422_PROXY,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Telecine: NONE | HARD
}
},
ColorMetadata: IGNORE | INSERT,
Crop: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
DropFrameTimecode: DISABLED | ENABLED,
FixedAfd: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
Position: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
RespondToAfd: NONE | RESPOND | PASSTHROUGH,
ScalingBehavior: DEFAULT | STRETCH_TO_OUTPUT,
Sharpness: 'NUMBER_VALUE',
TimecodeInsertion: DISABLED | PIC_TIMING_SEI,
VideoPreprocessors: {
ColorCorrector: {
Brightness: 'NUMBER_VALUE',
ColorSpaceConversion: NONE | FORCE_601 | FORCE_709 | FORCE_HDR10 | FORCE_HLG_2020,
Contrast: 'NUMBER_VALUE',
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Hue: 'NUMBER_VALUE',
Saturation: 'NUMBER_VALUE'
},
Deinterlacer: {
Algorithm: INTERPOLATE | INTERPOLATE_TICKER | BLEND | BLEND_TICKER,
Control: FORCE_ALL_FRAMES | NORMAL,
Mode: DEINTERLACE | INVERSE_TELECINE | ADAPTIVE
},
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
NoiseReducer: {
Filter: BILATERAL | MEAN | GAUSSIAN | LANCZOS | SHARPEN | CONSERVE | SPATIAL,
FilterSettings: {
Strength: 'NUMBER_VALUE'
},
SpatialFilterSettings: {
PostFilterSharpenStrength: 'NUMBER_VALUE',
Speed: 'NUMBER_VALUE',
Strength: 'NUMBER_VALUE'
}
},
TimecodeBurnin: {
FontSize: 'NUMBER_VALUE',
Position: TOP_CENTER | TOP_LEFT | TOP_RIGHT | MIDDLE_LEFT | MIDDLE_CENTER | MIDDLE_RIGHT | BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT,
Prefix: 'STRING_VALUE'
}
},
Width: 'NUMBER_VALUE'
}
},
Category: 'STRING_VALUE',
Description: 'STRING_VALUE',
Tags: {
'<__string>': 'STRING_VALUE',
/* '<__string>': ... */
}
};
mediaconvert.createPreset(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Category
— (String
) Optional. A category for the preset you are creating.Description
— (String
) Optional. A description of the preset you are creating.Name
— (String
) The name of the preset you are creating.Settings
— (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Tags
— (map<String>
) The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Preset
— (map
) A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your presets.CreatedAt
— (Date
) The timestamp in epoch seconds for preset creation.Description
— (String
) An optional description you create for each preset.LastUpdated
— (Date
) The timestamp in epoch seconds when the preset was last updated.Name
— required — (String
) A name you create for each preset. Each name must be unique within your account.Settings
— required — (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Type
— (String
) A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
createQueue(params = {}, callback) ⇒ AWS.Request
Create a new transcoding queue. For information about queues, see Working With Queues in the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html
Service Reference:
Examples:
Calling the createQueue operation
var params = {
Name: 'STRING_VALUE', /* required */
Description: 'STRING_VALUE',
PricingPlan: ON_DEMAND | RESERVED,
ReservationPlanSettings: {
Commitment: ONE_YEAR, /* required */
RenewalType: AUTO_RENEW | EXPIRE, /* required */
ReservedSlots: 'NUMBER_VALUE' /* required */
},
Tags: {
'<__string>': 'STRING_VALUE',
/* '<__string>': ... */
}
};
mediaconvert.createQueue(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Description
— (String
) Optional. A description of the queue that you are creating.Name
— (String
) The name of the queue that you are creating.PricingPlan
— (String
) Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment. When you use the API to create a queue, the default is on-demand. Possible values include:"ON_DEMAND"
"RESERVED"
ReservationPlanSettings
— (map
) Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.Commitment
— required — (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
RenewalType
— required — (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. When your term is auto renewed, you extend your commitment by 12 months from the auto renew date. You can cancel this commitment. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— required — (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. You can't decrease the number of RTS in your reserved queue. You can increase the number of RTS by extending your existing commitment with a new 12-month commitment for the larger number. The new commitment begins when you purchase the additional capacity. You can't cancel your commitment or revert to your original commitment after you increase the capacity.
Tags
— (map<String>
) The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Queue
— (map
) You can use queues to manage the resources that are available to your AWS account for running multiple transcoding jobs at the same time. If you don't specify a queue, the service sends all jobs through the default queue. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html.Arn
— (String
) An identifier for this resource that is unique within all of AWS.CreatedAt
— (Date
) The timestamp in epoch seconds for when you created the queue.Description
— (String
) An optional description that you create for each queue.LastUpdated
— (Date
) The timestamp in epoch seconds for when you most recently updated the queue.Name
— required — (String
) A name that you create for each queue. Each name must be unique within your account.PricingPlan
— (String
) Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment. Possible values include:"ON_DEMAND"
"RESERVED"
ProgressingJobsCount
— (Integer
) The estimated number of jobs with a PROGRESSING status.ReservationPlan
— (map
) Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.Commitment
— (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
ExpiresAt
— (Date
) The timestamp in epoch seconds for when the current pricing plan term for this reserved queue expires.PurchasedAt
— (Date
) The timestamp in epoch seconds for when you set up the current pricing plan for this reserved queue.RenewalType
— (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. When you increase this number, you extend your existing commitment with a new 12-month commitment for a larger number of RTS. The new commitment begins when you purchase the additional capacity. You can't decrease the number of RTS in your reserved queue.Status
— (String
) Specifies whether the pricing plan for your reserved queue is ACTIVE or EXPIRED. Possible values include:"ACTIVE"
"EXPIRED"
Status
— (String
) Queues can be ACTIVE or PAUSED. If you pause a queue, the service won't begin processing jobs in that queue. Jobs that are running when you pause the queue continue to run until they finish or result in an error. Possible values include:"ACTIVE"
"PAUSED"
SubmittedJobsCount
— (Integer
) The estimated number of jobs with a SUBMITTED status.Type
— (String
) Specifies whether this on-demand queue is system or custom. System queues are built in. You can't modify or delete system queues. You can create and modify custom queues. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
deleteJobTemplate(params = {}, callback) ⇒ AWS.Request
Permanently delete a job template you have created.
Service Reference:
Examples:
Calling the deleteJobTemplate operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.deleteJobTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the job template to be deleted.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deletePreset(params = {}, callback) ⇒ AWS.Request
Permanently delete a preset you have created.
Service Reference:
Examples:
Calling the deletePreset operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.deletePreset(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the preset to be deleted.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
deleteQueue(params = {}, callback) ⇒ AWS.Request
Permanently delete a queue you have created.
Service Reference:
Examples:
Calling the deleteQueue operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.deleteQueue(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the queue that you want to delete.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
describeEndpoints(params = {}, callback) ⇒ AWS.Request
Send an request with an empty body to the regional API endpoint to get your account API endpoint.
Service Reference:
Examples:
Calling the describeEndpoints operation
var params = {
MaxResults: 'NUMBER_VALUE',
Mode: DEFAULT | GET_ONLY,
NextToken: 'STRING_VALUE'
};
mediaconvert.describeEndpoints(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
MaxResults
— (Integer
) Optional. Max number of endpoints, up to twenty, that will be returned at one time.Mode
— (String
) Optional field, defaults to DEFAULT. Specify DEFAULT for this operation to return your endpoints if any exist, or to create an endpoint for you and return it if one doesn't already exist. Specify GET_ONLY to return your endpoints if any exist, or an empty list if none exist. Possible values include:"DEFAULT"
"GET_ONLY"
NextToken
— (String
) Use this string, provided with the response to a previous request, to request the next batch of endpoints.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Endpoints
— (Array<map>
) List of endpointsUrl
— (String
) URL of endpoint
NextToken
— (String
) Use this string to request the next batch of endpoints.
-
(AWS.Response)
—
Returns:
disassociateCertificate(params = {}, callback) ⇒ AWS.Request
Removes an association between the Amazon Resource Name (ARN) of an AWS Certificate Manager (ACM) certificate and an AWS Elemental MediaConvert resource.
Service Reference:
Examples:
Calling the disassociateCertificate operation
var params = {
Arn: 'STRING_VALUE' /* required */
};
mediaconvert.disassociateCertificate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Arn
— (String
) The ARN of the ACM certificate that you want to disassociate from your MediaConvert resource.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
getJob(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific completed transcoding job.
Service Reference:
Examples:
Calling the getJob operation
var params = {
Id: 'STRING_VALUE' /* required */
};
mediaconvert.getJob(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Id
— (String
) the job ID of the job.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Job
— (map
) Each job converts an input file into an output file or files. For more information, see the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.htmlAccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.BillingTagsSource
— (String
) Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted. Possible values include:"QUEUE"
"PRESET"
"JOB_TEMPLATE"
CreatedAt
— (Date
) The time, in Unix epoch format in seconds, when the job got created.CurrentPhase
— (String
) A job's phase can be PROBING, TRANSCODING OR UPLOADING Possible values include:"PROBING"
"TRANSCODING"
"UPLOADING"
ErrorCode
— (Integer
) Error code for the jobErrorMessage
— (String
) Error message of JobId
— (String
) A portion of the job's ARN, unique within your AWS Elemental MediaConvert resourcesJobPercentComplete
— (Integer
) An estimate of how far your job has progressed. This estimate is shown as a percentage of the total time from when your job leaves its queue to when your output files appear in your output Amazon S3 bucket. AWS Elemental MediaConvert provides jobPercentComplete in CloudWatch STATUS_UPDATE events and in the response to GetJob and ListJobs requests. The jobPercentComplete estimate is reliable for the following input containers: Quicktime, Transport Stream, MP4, and MXF. For some jobs, including audio-only jobs and jobs that use input clipping, the service can't provide information about job progress. In those cases, jobPercentComplete returns a null value.JobTemplate
— (String
) The job template that the job is created from, if it is created from a job template.OutputGroupDetails
— (Array<map>
) List of output group detailsOutputDetails
— (Array<map>
) Details about the outputDurationInMs
— (Integer
) Duration in millisecondsVideoDetails
— (map
) Contains details about the output's video streamHeightInPx
— (Integer
) Height in pixels for the outputWidthInPx
— (Integer
) Width in pixels for the output
Queue
— (String
) Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.htmlRetryCount
— (Integer
) The number of times that the service automatically attempted to process your job after encountering an error.Role
— required — (String
) The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.htmlSettings
— required — (map
) JobSettings contains all the transcode settings for a job.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DecryptionSettings
— (map
) Settings for decrypting any input files that you encrypt before you upload them to Amazon S3. MediaConvert can decrypt files only when you use AWS Key Management Service (KMS) to encrypt the data key that you use to encrypt your content.DecryptionMode
— (String
) Specify the encryption mode that you used to encrypt your input files. Possible values include:"AES_CTR"
"AES_CBC"
"AES_GCM"
EncryptedDecryptionKey
— (String
) Warning! Don't provide your encryption key in plaintext. Your job settings could be intercepted, making your encrypted content vulnerable. Specify the encrypted version of the data key that you used to encrypt your content. The data key must be encrypted by AWS Key Management Service (KMS). The key can be 128, 192, or 256 bits.InitializationVector
— (String
) Specify the initialization vector that you used when you encrypted your content before uploading it to Amazon S3. You can use a 16-byte initialization vector with any encryption mode. Or, you can use a 12-byte initialization vector with GCM or CTR. MediaConvert accepts only initialization vectors that are base64-encoded.KmsKeyRegion
— (String
) Specify the AWS Region for AWS Key Management Service (KMS) that you used to encrypt your data key, if that Region is different from the one you are using for AWS Elemental MediaConvert.
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FileInput
— (String
) Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. If your input format is IMF, specify your input by providing the path to your CPL. For example, "s3://bucket/vf/cpl.xml". If the CPL is in an incomplete IMP, make sure to use Supplemental IMPs (SupplementalImps) to specify any supplemental IMPs that contain assets referenced by the CPL.FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
SupplementalImps
— (Array<String>
) Provide a list of any necessary supplemental IMPs. You need supplemental IMPs if the CPL that you're using for your input is in an incomplete IMP. Specify either the supplemental IMP directories with a trailing slash or the ASSETMAP.xml files. For example ["s3://bucket/ov/", "s3://bucket/vf2/ASSETMAP.xml"]. You don't need to specify the IMP that contains your input CPL, because the service automatically detects it.TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
Status
— (String
) A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR. Possible values include:"SUBMITTED"
"PROGRESSING"
"COMPLETE"
"CANCELED"
"ERROR"
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Timing
— (map
) Information about when jobs are submitted, started, and finished is specified in Unix epoch format in seconds.FinishTime
— (Date
) The time, in Unix epoch format, that the transcoding job finishedStartTime
— (Date
) The time, in Unix epoch format, that transcoding for the job began.SubmitTime
— (Date
) The time, in Unix epoch format, that you submitted the job.
UserMetadata
— (map<String>
) User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs.
-
(AWS.Response)
—
Returns:
getJobTemplate(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific job template.
Service Reference:
Examples:
Calling the getJobTemplate operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.getJobTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the job template.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:JobTemplate
— (map
) A job template is a pre-made set of encoding instructions that you can use to quickly create a job.AccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your job templates.CreatedAt
— (Date
) The timestamp in epoch seconds for Job template creation.Description
— (String
) An optional description you create for each job template.LastUpdated
— (Date
) The timestamp in epoch seconds when the Job template was last updated.Name
— required — (String
) A name you create for each job template. Each name must be unique within your account.Queue
— (String
) Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue.Settings
— required — (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Type
— (String
) A job template can be of two types: system or custom. System or built-in job templates can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
getPreset(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific preset.
Service Reference:
Examples:
Calling the getPreset operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.getPreset(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the preset.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Preset
— (map
) A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your presets.CreatedAt
— (Date
) The timestamp in epoch seconds for preset creation.Description
— (String
) An optional description you create for each preset.LastUpdated
— (Date
) The timestamp in epoch seconds when the preset was last updated.Name
— required — (String
) A name you create for each preset. Each name must be unique within your account.Settings
— required — (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Type
— (String
) A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
getQueue(params = {}, callback) ⇒ AWS.Request
Retrieve the JSON for a specific queue.
Service Reference:
Examples:
Calling the getQueue operation
var params = {
Name: 'STRING_VALUE' /* required */
};
mediaconvert.getQueue(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Name
— (String
) The name of the queue that you want information about.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Queue
— (map
) You can use queues to manage the resources that are available to your AWS account for running multiple transcoding jobs at the same time. If you don't specify a queue, the service sends all jobs through the default queue. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html.Arn
— (String
) An identifier for this resource that is unique within all of AWS.CreatedAt
— (Date
) The timestamp in epoch seconds for when you created the queue.Description
— (String
) An optional description that you create for each queue.LastUpdated
— (Date
) The timestamp in epoch seconds for when you most recently updated the queue.Name
— required — (String
) A name that you create for each queue. Each name must be unique within your account.PricingPlan
— (String
) Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment. Possible values include:"ON_DEMAND"
"RESERVED"
ProgressingJobsCount
— (Integer
) The estimated number of jobs with a PROGRESSING status.ReservationPlan
— (map
) Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.Commitment
— (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
ExpiresAt
— (Date
) The timestamp in epoch seconds for when the current pricing plan term for this reserved queue expires.PurchasedAt
— (Date
) The timestamp in epoch seconds for when you set up the current pricing plan for this reserved queue.RenewalType
— (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. When you increase this number, you extend your existing commitment with a new 12-month commitment for a larger number of RTS. The new commitment begins when you purchase the additional capacity. You can't decrease the number of RTS in your reserved queue.Status
— (String
) Specifies whether the pricing plan for your reserved queue is ACTIVE or EXPIRED. Possible values include:"ACTIVE"
"EXPIRED"
Status
— (String
) Queues can be ACTIVE or PAUSED. If you pause a queue, the service won't begin processing jobs in that queue. Jobs that are running when you pause the queue continue to run until they finish or result in an error. Possible values include:"ACTIVE"
"PAUSED"
SubmittedJobsCount
— (Integer
) The estimated number of jobs with a SUBMITTED status.Type
— (String
) Specifies whether this on-demand queue is system or custom. System queues are built in. You can't modify or delete system queues. You can create and modify custom queues. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
listJobs(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your most recently created jobs. This array includes in-process, completed, and errored jobs. This will return the jobs themselves, not just a list of the jobs. To retrieve the twenty next most recent jobs, use the nextToken string returned with the array.
Service Reference:
Examples:
Calling the listJobs operation
var params = {
MaxResults: 'NUMBER_VALUE',
NextToken: 'STRING_VALUE',
Order: ASCENDING | DESCENDING,
Queue: 'STRING_VALUE',
Status: SUBMITTED | PROGRESSING | COMPLETE | CANCELED | ERROR
};
mediaconvert.listJobs(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
MaxResults
— (Integer
) Optional. Number of jobs, up to twenty, that will be returned at one time.NextToken
— (String
) Use this string, provided with the response to a previous request, to request the next batch of jobs.Order
— (String
) When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. Possible values include:"ASCENDING"
"DESCENDING"
Queue
— (String
) Provide a queue name to get back only jobs from that queue.Status
— (String
) A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR. Possible values include:"SUBMITTED"
"PROGRESSING"
"COMPLETE"
"CANCELED"
"ERROR"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Jobs
— (Array<map>
) List of jobsAccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.BillingTagsSource
— (String
) Optional. Choose a tag type that AWS Billing and Cost Management will use to sort your AWS Elemental MediaConvert costs on any billing report that you set up. Any transcoding outputs that don't have an associated tag will appear in your billing report unsorted. If you don't choose a valid value for this field, your job outputs will appear on the billing report unsorted. Possible values include:"QUEUE"
"PRESET"
"JOB_TEMPLATE"
CreatedAt
— (Date
) The time, in Unix epoch format in seconds, when the job got created.CurrentPhase
— (String
) A job's phase can be PROBING, TRANSCODING OR UPLOADING Possible values include:"PROBING"
"TRANSCODING"
"UPLOADING"
ErrorCode
— (Integer
) Error code for the jobErrorMessage
— (String
) Error message of JobId
— (String
) A portion of the job's ARN, unique within your AWS Elemental MediaConvert resourcesJobPercentComplete
— (Integer
) An estimate of how far your job has progressed. This estimate is shown as a percentage of the total time from when your job leaves its queue to when your output files appear in your output Amazon S3 bucket. AWS Elemental MediaConvert provides jobPercentComplete in CloudWatch STATUS_UPDATE events and in the response to GetJob and ListJobs requests. The jobPercentComplete estimate is reliable for the following input containers: Quicktime, Transport Stream, MP4, and MXF. For some jobs, including audio-only jobs and jobs that use input clipping, the service can't provide information about job progress. In those cases, jobPercentComplete returns a null value.JobTemplate
— (String
) The job template that the job is created from, if it is created from a job template.OutputGroupDetails
— (Array<map>
) List of output group detailsOutputDetails
— (Array<map>
) Details about the outputDurationInMs
— (Integer
) Duration in millisecondsVideoDetails
— (map
) Contains details about the output's video streamHeightInPx
— (Integer
) Height in pixels for the outputWidthInPx
— (Integer
) Width in pixels for the output
Queue
— (String
) Optional. When you create a job, you can specify a queue to send it to. If you don't specify, the job will go to the default queue. For more about queues, see the User Guide topic at http://docs.aws.amazon.com/mediaconvert/latest/ug/what-is.htmlRetryCount
— (Integer
) The number of times that the service automatically attempted to process your job after encountering an error.Role
— required — (String
) The IAM role you use for creating this job. For details about permissions, see the User Guide topic at the User Guide at http://docs.aws.amazon.com/mediaconvert/latest/ug/iam-role.htmlSettings
— required — (map
) JobSettings contains all the transcode settings for a job.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define source file used in the transcode job. There can be multiple inputs add in a job. These inputs will be concantenated together to create the output.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DecryptionSettings
— (map
) Settings for decrypting any input files that you encrypt before you upload them to Amazon S3. MediaConvert can decrypt files only when you use AWS Key Management Service (KMS) to encrypt the data key that you use to encrypt your content.DecryptionMode
— (String
) Specify the encryption mode that you used to encrypt your input files. Possible values include:"AES_CTR"
"AES_CBC"
"AES_GCM"
EncryptedDecryptionKey
— (String
) Warning! Don't provide your encryption key in plaintext. Your job settings could be intercepted, making your encrypted content vulnerable. Specify the encrypted version of the data key that you used to encrypt your content. The data key must be encrypted by AWS Key Management Service (KMS). The key can be 128, 192, or 256 bits.InitializationVector
— (String
) Specify the initialization vector that you used when you encrypted your content before uploading it to Amazon S3. You can use a 16-byte initialization vector with any encryption mode. Or, you can use a 12-byte initialization vector with GCM or CTR. MediaConvert accepts only initialization vectors that are base64-encoded.KmsKeyRegion
— (String
) Specify the AWS Region for AWS Key Management Service (KMS) that you used to encrypt your data key, if that Region is different from the one you are using for AWS Elemental MediaConvert.
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FileInput
— (String
) Specify the source file for your transcoding job. You can use multiple inputs in a single job. The service concatenates these inputs, in the order that you specify them in the job, to create the outputs. If your input format is IMF, specify your input by providing the path to your CPL. For example, "s3://bucket/vf/cpl.xml". If the CPL is in an incomplete IMP, make sure to use Supplemental IMPs (SupplementalImps) to specify any supplemental IMPs that contain assets referenced by the CPL.FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
SupplementalImps
— (Array<String>
) Provide a list of any necessary supplemental IMPs. You need supplemental IMPs if the CPL that you're using for your input is in an incomplete IMP. Specify either the supplemental IMP directories with a trailing slash or the ASSETMAP.xml files. For example ["s3://bucket/ov/", "s3://bucket/vf2/ASSETMAP.xml"]. You don't need to specify the IMP that contains your input CPL, because the service automatically detects it.TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
Status
— (String
) A job's status can be SUBMITTED, PROGRESSING, COMPLETE, CANCELED, or ERROR. Possible values include:"SUBMITTED"
"PROGRESSING"
"COMPLETE"
"CANCELED"
"ERROR"
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Timing
— (map
) Information about when jobs are submitted, started, and finished is specified in Unix epoch format in seconds.FinishTime
— (Date
) The time, in Unix epoch format, that the transcoding job finishedStartTime
— (Date
) The time, in Unix epoch format, that transcoding for the job began.SubmitTime
— (Date
) The time, in Unix epoch format, that you submitted the job.
UserMetadata
— (map<String>
) User-defined metadata that you want to associate with an MediaConvert job. You specify metadata in key/value pairs.
NextToken
— (String
) Use this string to request the next batch of jobs.
-
(AWS.Response)
—
Returns:
listJobTemplates(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your job templates. This will return the templates themselves, not just a list of them. To retrieve the next twenty templates, use the nextToken string returned with the array
Service Reference:
Examples:
Calling the listJobTemplates operation
var params = {
Category: 'STRING_VALUE',
ListBy: NAME | CREATION_DATE | SYSTEM,
MaxResults: 'NUMBER_VALUE',
NextToken: 'STRING_VALUE',
Order: ASCENDING | DESCENDING
};
mediaconvert.listJobTemplates(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Category
— (String
) Optionally, specify a job template category to limit responses to only job templates from that category.ListBy
— (String
) Optional. When you request a list of job templates, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name. Possible values include:"NAME"
"CREATION_DATE"
"SYSTEM"
MaxResults
— (Integer
) Optional. Number of job templates, up to twenty, that will be returned at one time.NextToken
— (String
) Use this string, provided with the response to a previous request, to request the next batch of job templates.Order
— (String
) When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. Possible values include:"ASCENDING"
"DESCENDING"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:JobTemplates
— (Array<map>
) List of Job templates.AccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your job templates.CreatedAt
— (Date
) The timestamp in epoch seconds for Job template creation.Description
— (String
) An optional description you create for each job template.LastUpdated
— (Date
) The timestamp in epoch seconds when the Job template was last updated.Name
— required — (String
) A name you create for each job template. Each name must be unique within your account.Queue
— (String
) Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue.Settings
— required — (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Type
— (String
) A job template can be of two types: system or custom. System or built-in job templates can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
NextToken
— (String
) Use this string to request the next batch of job templates.
-
(AWS.Response)
—
Returns:
listPresets(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your presets. This will return the presets themselves, not just a list of them. To retrieve the next twenty presets, use the nextToken string returned with the array.
Service Reference:
Examples:
Calling the listPresets operation
var params = {
Category: 'STRING_VALUE',
ListBy: NAME | CREATION_DATE | SYSTEM,
MaxResults: 'NUMBER_VALUE',
NextToken: 'STRING_VALUE',
Order: ASCENDING | DESCENDING
};
mediaconvert.listPresets(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Category
— (String
) Optionally, specify a preset category to limit responses to only presets from that category.ListBy
— (String
) Optional. When you request a list of presets, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by name. Possible values include:"NAME"
"CREATION_DATE"
"SYSTEM"
MaxResults
— (Integer
) Optional. Number of presets, up to twenty, that will be returned at one timeNextToken
— (String
) Use this string, provided with the response to a previous request, to request the next batch of presets.Order
— (String
) When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. Possible values include:"ASCENDING"
"DESCENDING"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:NextToken
— (String
) Use this string to request the next batch of presets.Presets
— (Array<map>
) List of presetsArn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your presets.CreatedAt
— (Date
) The timestamp in epoch seconds for preset creation.Description
— (String
) An optional description you create for each preset.LastUpdated
— (Date
) The timestamp in epoch seconds when the preset was last updated.Name
— required — (String
) A name you create for each preset. Each name must be unique within your account.Settings
— required — (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Type
— (String
) A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
listQueues(params = {}, callback) ⇒ AWS.Request
Retrieve a JSON array of up to twenty of your queues. This will return the queues themselves, not just a list of them. To retrieve the next twenty queues, use the nextToken string returned with the array.
Service Reference:
Examples:
Calling the listQueues operation
var params = {
ListBy: NAME | CREATION_DATE,
MaxResults: 'NUMBER_VALUE',
NextToken: 'STRING_VALUE',
Order: ASCENDING | DESCENDING
};
mediaconvert.listQueues(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
ListBy
— (String
) Optional. When you request a list of queues, you can choose to list them alphabetically by NAME or chronologically by CREATION_DATE. If you don't specify, the service will list them by creation date. Possible values include:"NAME"
"CREATION_DATE"
MaxResults
— (Integer
) Optional. Number of queues, up to twenty, that will be returned at one time.NextToken
— (String
) Use this string, provided with the response to a previous request, to request the next batch of queues.Order
— (String
) When you request lists of resources, you can optionally specify whether they are sorted in ASCENDING or DESCENDING order. Default varies by resource. Possible values include:"ASCENDING"
"DESCENDING"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:NextToken
— (String
) Use this string to request the next batch of queues.Queues
— (Array<map>
) List of queues.Arn
— (String
) An identifier for this resource that is unique within all of AWS.CreatedAt
— (Date
) The timestamp in epoch seconds for when you created the queue.Description
— (String
) An optional description that you create for each queue.LastUpdated
— (Date
) The timestamp in epoch seconds for when you most recently updated the queue.Name
— required — (String
) A name that you create for each queue. Each name must be unique within your account.PricingPlan
— (String
) Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment. Possible values include:"ON_DEMAND"
"RESERVED"
ProgressingJobsCount
— (Integer
) The estimated number of jobs with a PROGRESSING status.ReservationPlan
— (map
) Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.Commitment
— (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
ExpiresAt
— (Date
) The timestamp in epoch seconds for when the current pricing plan term for this reserved queue expires.PurchasedAt
— (Date
) The timestamp in epoch seconds for when you set up the current pricing plan for this reserved queue.RenewalType
— (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. When you increase this number, you extend your existing commitment with a new 12-month commitment for a larger number of RTS. The new commitment begins when you purchase the additional capacity. You can't decrease the number of RTS in your reserved queue.Status
— (String
) Specifies whether the pricing plan for your reserved queue is ACTIVE or EXPIRED. Possible values include:"ACTIVE"
"EXPIRED"
Status
— (String
) Queues can be ACTIVE or PAUSED. If you pause a queue, the service won't begin processing jobs in that queue. Jobs that are running when you pause the queue continue to run until they finish or result in an error. Possible values include:"ACTIVE"
"PAUSED"
SubmittedJobsCount
— (Integer
) The estimated number of jobs with a SUBMITTED status.Type
— (String
) Specifies whether this on-demand queue is system or custom. System queues are built in. You can't modify or delete system queues. You can create and modify custom queues. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
listTagsForResource(params = {}, callback) ⇒ AWS.Request
Retrieve the tags for a MediaConvert resource.
Service Reference:
Examples:
Calling the listTagsForResource operation
var params = {
Arn: 'STRING_VALUE' /* required */
};
mediaconvert.listTagsForResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Arn
— (String
) The Amazon Resource Name (ARN) of the resource that you want to list tags for. To get the ARN, send a GET request with the resource name.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:ResourceTags
— (map
) The Amazon Resource Name (ARN) and tags for an AWS Elemental MediaConvert resource.Arn
— (String
) The Amazon Resource Name (ARN) of the resource.Tags
— (map<String>
) The tags for the resource.
-
(AWS.Response)
—
Returns:
tagResource(params = {}, callback) ⇒ AWS.Request
Add tags to a MediaConvert queue, preset, or job template. For information about tagging, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html
Service Reference:
Examples:
Calling the tagResource operation
var params = {
Arn: 'STRING_VALUE', /* required */
Tags: { /* required */
'<__string>': 'STRING_VALUE',
/* '<__string>': ... */
}
};
mediaconvert.tagResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Arn
— (String
) The Amazon Resource Name (ARN) of the resource that you want to tag. To get the ARN, send a GET request with the resource name.Tags
— (map<String>
) The tags that you want to add to the resource. You can tag resources with a key-value pair or with only a key.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
untagResource(params = {}, callback) ⇒ AWS.Request
Remove tags from a MediaConvert queue, preset, or job template. For information about tagging, see the User Guide at https://docs.aws.amazon.com/mediaconvert/latest/ug/tagging-resources.html
Service Reference:
Examples:
Calling the untagResource operation
var params = {
Arn: 'STRING_VALUE', /* required */
TagKeys: [
'STRING_VALUE',
/* more items */
]
};
mediaconvert.untagResource(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Arn
— (String
) The Amazon Resource Name (ARN) of the resource that you want to remove tags from. To get the ARN, send a GET request with the resource name.TagKeys
— (Array<String>
) The keys of the tags that you want to remove from the resource.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs.
-
(AWS.Response)
—
Returns:
updateJobTemplate(params = {}, callback) ⇒ AWS.Request
Modify one of your existing job templates.
Service Reference:
Examples:
Calling the updateJobTemplate operation
var params = {
Name: 'STRING_VALUE', /* required */
AccelerationSettings: {
Mode: DISABLED | ENABLED /* required */
},
Category: 'STRING_VALUE',
Description: 'STRING_VALUE',
Queue: 'STRING_VALUE',
Settings: {
AdAvailOffset: 'NUMBER_VALUE',
AvailBlanking: {
AvailBlankingImage: 'STRING_VALUE'
},
Esam: {
ManifestConfirmConditionNotification: {
MccXml: 'STRING_VALUE'
},
ResponseSignalPreroll: 'NUMBER_VALUE',
SignalProcessingNotification: {
SccXml: 'STRING_VALUE'
}
},
Inputs: [
{
AudioSelectorGroups: {
'<__string>': {
AudioSelectorNames: [
'STRING_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
AudioSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
DefaultSelection: DEFAULT | NOT_DEFAULT,
ExternalAudioFileInput: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
Offset: 'NUMBER_VALUE',
Pids: [
'NUMBER_VALUE',
/* more items */
],
ProgramSelection: 'NUMBER_VALUE',
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
SelectorType: PID | TRACK | LANGUAGE_CODE,
Tracks: [
'NUMBER_VALUE',
/* more items */
]
},
/* '<__string>': ... */
},
CaptionSelectors: {
'<__string>': {
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
SourceSettings: {
AncillarySourceSettings: {
SourceAncillaryChannelNumber: 'NUMBER_VALUE'
},
DvbSubSourceSettings: {
Pid: 'NUMBER_VALUE'
},
EmbeddedSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
Source608ChannelNumber: 'NUMBER_VALUE',
Source608TrackNumber: 'NUMBER_VALUE'
},
FileSourceSettings: {
Convert608To708: UPCONVERT | DISABLED,
SourceFile: 'STRING_VALUE',
TimeDelta: 'NUMBER_VALUE'
},
SourceType: ANCILLARY | DVB_SUB | EMBEDDED | SCTE20 | SCC | TTML | STL | SRT | SMI | TELETEXT | NULL_SOURCE | IMSC,
TeletextSourceSettings: {
PageNumber: 'STRING_VALUE'
},
TrackSourceSettings: {
TrackNumber: 'NUMBER_VALUE'
}
}
},
/* '<__string>': ... */
},
DeblockFilter: ENABLED | DISABLED,
DenoiseFilter: ENABLED | DISABLED,
FilterEnable: AUTO | DISABLE | FORCE,
FilterStrength: 'NUMBER_VALUE',
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
InputClippings: [
{
EndTimecode: 'STRING_VALUE',
StartTimecode: 'STRING_VALUE'
},
/* more items */
],
ProgramNumber: 'NUMBER_VALUE',
PsiControl: IGNORE_PSI | USE_PSI,
TimecodeSource: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
VideoSelector: {
ColorSpace: FOLLOW | REC_601 | REC_709 | HDR10 | HLG_2020,
ColorSpaceUsage: FORCE | FALLBACK,
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Pid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Rotate: DEGREE_0 | DEGREES_90 | DEGREES_180 | DEGREES_270 | AUTO
}
},
/* more items */
],
MotionImageInserter: {
Framerate: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE'
},
Input: 'STRING_VALUE',
InsertionMode: MOV | PNG,
Offset: {
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE'
},
Playback: ONCE | REPEAT,
StartTime: 'STRING_VALUE'
},
NielsenConfiguration: {
BreakoutCode: 'NUMBER_VALUE',
DistributorId: 'STRING_VALUE'
},
OutputGroups: [
{
CustomName: 'STRING_VALUE',
Name: 'STRING_VALUE',
OutputGroupSettings: {
CmafGroupSettings: {
BaseUrl: 'STRING_VALUE',
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: STATIC_KEY
},
FragmentLength: 'NUMBER_VALUE',
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinBufferTime: 'NUMBER_VALUE',
MinFinalSegmentLength: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
WriteDashManifest: DISABLED | ENABLED,
WriteHlsManifest: DISABLED | ENABLED
},
DashIsoGroupSettings: {
BaseUrl: 'STRING_VALUE',
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
HbbtvCompliance: HBBTV_1_5 | NONE,
MinBufferTime: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
WriteSegmentTimelineInRepresentation: ENABLED | DISABLED
},
FileGroupSettings: {
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
}
},
HlsGroupSettings: {
AdMarkers: [
ELEMENTAL | ELEMENTAL_SCTE35,
/* more items */
],
BaseUrl: 'STRING_VALUE',
CaptionLanguageMappings: [
{
CaptionChannel: 'NUMBER_VALUE',
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
CaptionLanguageSetting: INSERT | OMIT | NONE,
ClientCache: DISABLED | ENABLED,
CodecSpecification: RFC_6381 | RFC_4281,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
DirectoryStructure: SINGLE_DIRECTORY | SUBDIRECTORY_PER_STREAM,
Encryption: {
ConstantInitializationVector: 'STRING_VALUE',
EncryptionMethod: AES128 | SAMPLE_AES,
InitializationVectorInManifest: INCLUDE | EXCLUDE,
OfflineEncrypted: ENABLED | DISABLED,
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
},
StaticKeyProvider: {
KeyFormat: 'STRING_VALUE',
KeyFormatVersions: 'STRING_VALUE',
StaticKeyValue: 'STRING_VALUE',
Url: 'STRING_VALUE'
},
Type: SPEKE | STATIC_KEY
},
ManifestCompression: GZIP | NONE,
ManifestDurationFormat: FLOATING_POINT | INTEGER,
MinFinalSegmentLength: 'NUMBER_VALUE',
MinSegmentLength: 'NUMBER_VALUE',
OutputSelection: MANIFESTS_AND_SEGMENTS | SEGMENTS_ONLY,
ProgramDateTime: INCLUDE | EXCLUDE,
ProgramDateTimePeriod: 'NUMBER_VALUE',
SegmentControl: SINGLE_FILE | SEGMENTED_FILES,
SegmentLength: 'NUMBER_VALUE',
SegmentsPerSubdirectory: 'NUMBER_VALUE',
StreamInfResolution: INCLUDE | EXCLUDE,
TimedMetadataId3Frame: NONE | PRIV | TDRL,
TimedMetadataId3Period: 'NUMBER_VALUE',
TimestampDeltaMilliseconds: 'NUMBER_VALUE'
},
MsSmoothGroupSettings: {
AudioDeduplication: COMBINE_DUPLICATE_STREAMS | NONE,
Destination: 'STRING_VALUE',
DestinationSettings: {
S3Settings: {
Encryption: {
EncryptionType: SERVER_SIDE_ENCRYPTION_S3 | SERVER_SIDE_ENCRYPTION_KMS,
KmsKeyArn: 'STRING_VALUE'
}
}
},
Encryption: {
SpekeKeyProvider: {
CertificateArn: 'STRING_VALUE',
ResourceId: 'STRING_VALUE',
SystemIds: [
'STRING_VALUE',
/* more items */
],
Url: 'STRING_VALUE'
}
},
FragmentLength: 'NUMBER_VALUE',
ManifestEncoding: UTF8 | UTF16
},
Type: HLS_GROUP_SETTINGS | DASH_ISO_GROUP_SETTINGS | FILE_GROUP_SETTINGS | MS_SMOOTH_GROUP_SETTINGS | CMAF_GROUP_SETTINGS
},
Outputs: [
{
AudioDescriptions: [
{
AudioNormalizationSettings: {
Algorithm: ITU_BS_1770_1 | ITU_BS_1770_2,
AlgorithmControl: CORRECT_AUDIO | MEASURE_ONLY,
CorrectionGateLevel: 'NUMBER_VALUE',
LoudnessLogging: LOG | DONT_LOG,
PeakCalculation: TRUE_PEAK | NONE,
TargetLkfs: 'NUMBER_VALUE'
},
AudioSourceName: 'STRING_VALUE',
AudioType: 'NUMBER_VALUE',
AudioTypeControl: FOLLOW_INPUT | USE_CONFIGURED,
CodecSettings: {
AacSettings: {
AudioDescriptionBroadcasterMix: BROADCASTER_MIXED_AD | NORMAL,
Bitrate: 'NUMBER_VALUE',
CodecProfile: LC | HEV1 | HEV2,
CodingMode: AD_RECEIVER_MIX | CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_5_1,
RateControlMode: CBR | VBR,
RawFormat: LATM_LOAS | NONE,
SampleRate: 'NUMBER_VALUE',
Specification: MPEG2 | MPEG4,
VbrQuality: LOW | MEDIUM_LOW | MEDIUM_HIGH | HIGH
},
Ac3Settings: {
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | DIALOGUE | EMERGENCY | HEARING_IMPAIRED | MUSIC_AND_EFFECTS | VISUALLY_IMPAIRED | VOICE_OVER,
CodingMode: CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_3_2_LFE,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionProfile: FILM_STANDARD | NONE,
LfeFilter: ENABLED | DISABLED,
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
SampleRate: 'NUMBER_VALUE'
},
AiffSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
Codec: AAC | MP2 | WAV | AIFF | AC3 | EAC3 | PASSTHROUGH,
Eac3Settings: {
AttenuationControl: ATTENUATE_3_DB | NONE,
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | EMERGENCY | HEARING_IMPAIRED | VISUALLY_IMPAIRED,
CodingMode: CODING_MODE_1_0 | CODING_MODE_2_0 | CODING_MODE_3_2,
DcFilter: ENABLED | DISABLED,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionLine: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
DynamicRangeCompressionRf: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
LfeControl: LFE | NO_LFE,
LfeFilter: ENABLED | DISABLED,
LoRoCenterMixLevel: 'NUMBER_VALUE',
LoRoSurroundMixLevel: 'NUMBER_VALUE',
LtRtCenterMixLevel: 'NUMBER_VALUE',
LtRtSurroundMixLevel: 'NUMBER_VALUE',
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
PassthroughControl: WHEN_POSSIBLE | NO_PASSTHROUGH,
PhaseControl: SHIFT_90_DEGREES | NO_SHIFT,
SampleRate: 'NUMBER_VALUE',
StereoDownmix: NOT_INDICATED | LO_RO | LT_RT | DPL2,
SurroundExMode: NOT_INDICATED | ENABLED | DISABLED,
SurroundMode: NOT_INDICATED | ENABLED | DISABLED
},
Mp2Settings: {
Bitrate: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
WavSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
Format: RIFF | RF64,
SampleRate: 'NUMBER_VALUE'
}
},
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageCodeControl: FOLLOW_INPUT | USE_CONFIGURED,
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
StreamName: 'STRING_VALUE'
},
/* more items */
],
CaptionDescriptions: [
{
CaptionSelectorName: 'STRING_VALUE',
CustomLanguageCode: 'STRING_VALUE',
DestinationSettings: {
BurninDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
DestinationType: BURN_IN | DVB_SUB | EMBEDDED | EMBEDDED_PLUS_SCTE20 | SCTE20_PLUS_EMBEDDED | SCC | SRT | SMI | TELETEXT | TTML | WEBVTT,
DvbSubDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
EmbeddedDestinationSettings: {
Destination608ChannelNumber: 'NUMBER_VALUE'
},
SccDestinationSettings: {
Framerate: FRAMERATE_23_97 | FRAMERATE_24 | FRAMERATE_29_97_DROPFRAME | FRAMERATE_29_97_NON_DROPFRAME
},
TeletextDestinationSettings: {
PageNumber: 'STRING_VALUE'
},
TtmlDestinationSettings: {
StylePassthrough: ENABLED | DISABLED
}
},
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
ContainerSettings: {
Container: F4V | ISMV | M2TS | M3U8 | CMFC | MOV | MP4 | MPD | MXF | RAW,
F4vSettings: {
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL
},
M2tsSettings: {
AudioBufferModel: DVB | ATSC,
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
Bitrate: 'NUMBER_VALUE',
BufferModel: MULTIPLEX | NONE,
DvbNitSettings: {
NetworkId: 'NUMBER_VALUE',
NetworkName: 'STRING_VALUE',
NitInterval: 'NUMBER_VALUE'
},
DvbSdtSettings: {
OutputSdt: SDT_FOLLOW | SDT_FOLLOW_IF_PRESENT | SDT_MANUAL | SDT_NONE,
SdtInterval: 'NUMBER_VALUE',
ServiceName: 'STRING_VALUE',
ServiceProviderName: 'STRING_VALUE'
},
DvbSubPids: [
'NUMBER_VALUE',
/* more items */
],
DvbTdtSettings: {
TdtInterval: 'NUMBER_VALUE'
},
DvbTeletextPid: 'NUMBER_VALUE',
EbpAudioInterval: VIDEO_AND_FIXED_INTERVALS | VIDEO_INTERVAL,
EbpPlacement: VIDEO_AND_AUDIO_PIDS | VIDEO_PID,
EsRateInPes: INCLUDE | EXCLUDE,
ForceTsVideoEbpOrder: FORCE | DEFAULT,
FragmentTime: 'NUMBER_VALUE',
MaxPcrInterval: 'NUMBER_VALUE',
MinEbpInterval: 'NUMBER_VALUE',
NielsenId3: INSERT | NONE,
NullPacketBitrate: 'NUMBER_VALUE',
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
RateMode: VBR | CBR,
Scte35Esam: {
Scte35EsamPid: 'NUMBER_VALUE'
},
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
SegmentationMarkers: NONE | RAI_SEGSTART | RAI_ADAPT | PSI_SEGSTART | EBP | EBP_LEGACY,
SegmentationStyle: MAINTAIN_CADENCE | RESET_CADENCE,
SegmentationTime: 'NUMBER_VALUE',
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
M3u8Settings: {
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
NielsenId3: INSERT | NONE,
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
TimedMetadata: PASSTHROUGH | NONE,
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
MovSettings: {
ClapAtom: INCLUDE | EXCLUDE,
CslgAtom: INCLUDE | EXCLUDE,
Mpeg2FourCCControl: XDCAM | MPEG,
PaddingControl: OMNEON | NONE,
Reference: SELF_CONTAINED | EXTERNAL
},
Mp4Settings: {
CslgAtom: INCLUDE | EXCLUDE,
FreeSpaceBox: INCLUDE | EXCLUDE,
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL,
Mp4MajorBrand: 'STRING_VALUE'
}
},
Extension: 'STRING_VALUE',
NameModifier: 'STRING_VALUE',
OutputSettings: {
HlsSettings: {
AudioGroupId: 'STRING_VALUE',
AudioRenditionSets: 'STRING_VALUE',
AudioTrackType: ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT | ALTERNATE_AUDIO_AUTO_SELECT | ALTERNATE_AUDIO_NOT_AUTO_SELECT | AUDIO_ONLY_VARIANT_STREAM,
IFrameOnlyManifest: INCLUDE | EXCLUDE,
SegmentModifier: 'STRING_VALUE'
}
},
Preset: 'STRING_VALUE',
VideoDescription: {
AfdSignaling: NONE | AUTO | FIXED,
AntiAlias: DISABLED | ENABLED,
CodecSettings: {
Codec: FRAME_CAPTURE | H_264 | H_265 | MPEG2 | PRORES,
FrameCaptureSettings: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
MaxCaptures: 'NUMBER_VALUE',
Quality: 'NUMBER_VALUE'
},
H264Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_1_1 | LEVEL_1_2 | LEVEL_1_3 | LEVEL_2 | LEVEL_2_1 | LEVEL_2_2 | LEVEL_3 | LEVEL_3_1 | LEVEL_3_2 | LEVEL_4 | LEVEL_4_1 | LEVEL_4_2 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2,
CodecProfile: BASELINE | HIGH | HIGH_10BIT | HIGH_422 | HIGH_422_10BIT | MAIN,
DynamicSubGop: ADAPTIVE | STATIC,
EntropyEncoding: CABAC | CAVLC,
FieldEncoding: PAFF | FORCE_FIELD,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
RepeatPps: DISABLED | ENABLED,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | RP2027,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED
},
H265Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
AlternateTransferFunctionSei: DISABLED | ENABLED,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_2 | LEVEL_2_1 | LEVEL_3 | LEVEL_3_1 | LEVEL_4 | LEVEL_4_1 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2 | LEVEL_6 | LEVEL_6_1 | LEVEL_6_2,
CodecProfile: MAIN_MAIN | MAIN_HIGH | MAIN10_MAIN | MAIN10_HIGH | MAIN_422_8BIT_MAIN | MAIN_422_8BIT_HIGH | MAIN_422_10BIT_MAIN | MAIN_422_10BIT_HIGH,
DynamicSubGop: ADAPTIVE | STATIC,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
SampleAdaptiveOffsetFilterMode: DEFAULT | ADAPTIVE | OFF,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
TemporalIds: DISABLED | ENABLED,
Tiles: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED,
WriteMp4PackagingType: HVC1 | HEV1
},
Mpeg2Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LOW | MAIN | HIGH1440 | HIGH,
CodecProfile: MAIN | PROFILE_422,
DynamicSubGop: ADAPTIVE | STATIC,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
IntraDcPrecision: AUTO | INTRA_DC_PRECISION_8 | INTRA_DC_PRECISION_9 | INTRA_DC_PRECISION_10 | INTRA_DC_PRECISION_11,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | MULTI_PASS,
RateControlMode: VBR | CBR,
SceneChangeDetect: DISABLED | ENABLED,
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | D_10,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED
},
ProresSettings: {
CodecProfile: APPLE_PRORES_422 | APPLE_PRORES_422_HQ | APPLE_PRORES_422_LT | APPLE_PRORES_422_PROXY,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Telecine: NONE | HARD
}
},
ColorMetadata: IGNORE | INSERT,
Crop: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
DropFrameTimecode: DISABLED | ENABLED,
FixedAfd: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
Position: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
RespondToAfd: NONE | RESPOND | PASSTHROUGH,
ScalingBehavior: DEFAULT | STRETCH_TO_OUTPUT,
Sharpness: 'NUMBER_VALUE',
TimecodeInsertion: DISABLED | PIC_TIMING_SEI,
VideoPreprocessors: {
ColorCorrector: {
Brightness: 'NUMBER_VALUE',
ColorSpaceConversion: NONE | FORCE_601 | FORCE_709 | FORCE_HDR10 | FORCE_HLG_2020,
Contrast: 'NUMBER_VALUE',
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Hue: 'NUMBER_VALUE',
Saturation: 'NUMBER_VALUE'
},
Deinterlacer: {
Algorithm: INTERPOLATE | INTERPOLATE_TICKER | BLEND | BLEND_TICKER,
Control: FORCE_ALL_FRAMES | NORMAL,
Mode: DEINTERLACE | INVERSE_TELECINE | ADAPTIVE
},
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
NoiseReducer: {
Filter: BILATERAL | MEAN | GAUSSIAN | LANCZOS | SHARPEN | CONSERVE | SPATIAL,
FilterSettings: {
Strength: 'NUMBER_VALUE'
},
SpatialFilterSettings: {
PostFilterSharpenStrength: 'NUMBER_VALUE',
Speed: 'NUMBER_VALUE',
Strength: 'NUMBER_VALUE'
}
},
TimecodeBurnin: {
FontSize: 'NUMBER_VALUE',
Position: TOP_CENTER | TOP_LEFT | TOP_RIGHT | MIDDLE_LEFT | MIDDLE_CENTER | MIDDLE_RIGHT | BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT,
Prefix: 'STRING_VALUE'
}
},
Width: 'NUMBER_VALUE'
}
},
/* more items */
]
},
/* more items */
],
TimecodeConfig: {
Anchor: 'STRING_VALUE',
Source: EMBEDDED | ZEROBASED | SPECIFIEDSTART,
Start: 'STRING_VALUE',
TimestampOffset: 'STRING_VALUE'
},
TimedMetadataInsertion: {
Id3Insertions: [
{
Id3: 'STRING_VALUE',
Timecode: 'STRING_VALUE'
},
/* more items */
]
}
},
StatusUpdateInterval: SECONDS_10 | SECONDS_12 | SECONDS_15 | SECONDS_20 | SECONDS_30 | SECONDS_60 | SECONDS_120 | SECONDS_180 | SECONDS_240 | SECONDS_300 | SECONDS_360 | SECONDS_420 | SECONDS_480 | SECONDS_540 | SECONDS_600
};
mediaconvert.updateJobTemplate(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
AccelerationSettings
— (map
) This is a beta feature. If you are interested in using this feature, please contact AWS customer support.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Category
— (String
) The new category for the job template, if you are changing it.Description
— (String
) The new description for the job template, if you are changing it.Name
— (String
) The name of the job template you are modifyingQueue
— (String
) The new queue for the job template, if you are changing it.Settings
— (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:JobTemplate
— (map
) A job template is a pre-made set of encoding instructions that you can use to quickly create a job.AccelerationSettings
— (map
) Accelerated transcoding is currently in private preview. Contact AWS for more information.Mode
— required — (String
) Acceleration configuration for the job. Possible values include:"DISABLED"
"ENABLED"
Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your job templates.CreatedAt
— (Date
) The timestamp in epoch seconds for Job template creation.Description
— (String
) An optional description you create for each job template.LastUpdated
— (Date
) The timestamp in epoch seconds when the Job template was last updated.Name
— required — (String
) A name you create for each job template. Each name must be unique within your account.Queue
— (String
) Optional. The queue that jobs created from this template are assigned to. If you don't specify this, jobs will go to the default queue.Settings
— required — (map
) JobTemplateSettings contains all the transcode settings saved in the template that will be applied to jobs created from it.AdAvailOffset
— (Integer
) When specified, this offset (in milliseconds) is added to the input Ad Avail PTS time.AvailBlanking
— (map
) Settings for ad avail blanking. Video can be blanked or overlaid with an image, and audio muted during SCTE-35 triggered ad avails.AvailBlankingImage
— (String
) Blanking image to be used. Leave empty for solid black. Only bmp and png images are supported.
Esam
— (map
) Settings for Event Signaling And Messaging (ESAM).ManifestConfirmConditionNotification
— (map
) Specifies an ESAM ManifestConfirmConditionNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the manifest conditioning instructions that you provide in the setting MCC XML (mccXml).MccXml
— (String
) Provide your ESAM ManifestConfirmConditionNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the Manifest Conditioning instructions in the message that you supply.
ResponseSignalPreroll
— (Integer
) Specifies the stream distance, in milliseconds, between the SCTE 35 messages that the transcoder places and the splice points that they refer to. If the time between the start of the asset and the SCTE-35 message is less than this value, then the transcoder places the SCTE-35 marker at the beginning of the stream.SignalProcessingNotification
— (map
) Specifies an ESAM SignalProcessingNotification XML as per OC-SP-ESAM-API-I03-131025. The transcoder uses the signal processing instructions that you provide in the setting SCC XML (sccXml).SccXml
— (String
) Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. Form the XML document as per OC-SP-ESAM-API-I03-131025. The transcoder will use the signal processing instructions in the message that you supply. Provide your ESAM SignalProcessingNotification XML document inside your JSON job settings. If you want the service to place SCTE-35 markers at the insertion points you specify in the XML document, you must also enable SCTE-35 ESAM (scte35Esam). Note that you can either specify an ESAM XML document or enable SCTE-35 passthrough. You can't do both.
Inputs
— (Array<map>
) Use Inputs (inputs) to define the source file used in the transcode job. There can only be one input in a job template. Using the API, you can include multiple inputs when referencing a job template.AudioSelectorGroups
— (map<map>
) Specifies set of audio selectors within an input to combine. An input may have multiple audio selector groups. See "Audio Selector Group":#inputs-audio_selector_group for more information.AudioSelectorNames
— (Array<String>
) Name of an Audio Selector within the same input to include in the group. Audio selector names are standardized, based on their order within the input (e.g., "Audio Selector 1"). The audio selector name parameter can be repeated to add any number of audio selectors to the group.
AudioSelectors
— (map<map>
) Use Audio selectors (AudioSelectors) to specify a track or set of tracks from the input that you will use in your outputs. You can use mutiple Audio selectors per input.CustomLanguageCode
— (String
) Selects a specific language code from within an audio source, using the ISO 639-2 or ISO 639-3 three-letter language codeDefaultSelection
— (String
) Enable this setting on one audio selector to set it as the default for the job. The service uses this default for outputs where it can't find the specified input audio. If you don't set a default, those outputs have no audio. Possible values include:"DEFAULT"
"NOT_DEFAULT"
ExternalAudioFileInput
— (String
) Specifies audio data from an external file source.LanguageCode
— (String
) Selects a specific language code from within an audio source. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
Offset
— (Integer
) Specifies a time delta in milliseconds to offset the audio from the input video.Pids
— (Array<Integer>
) Selects a specific PID from within an audio source (e.g. 257 selects PID 0x101).ProgramSelection
— (Integer
) Use this setting for input streams that contain Dolby E, to have the service extract specific program data from the track. To select multiple programs, create multiple selectors with the same Track and different Program numbers. In the console, this setting is visible when you set Selector type to Track. Choose the program number from the dropdown list. If you are sending a JSON file, provide the program ID, which is part of the audio metadata. If your input file has incorrect metadata, you can choose All channels instead of a program number to have the service ignore the program IDs and include all the programs in the track.RemixSettings
— (map
) Use these settings to reorder the audio channels of one input to match those of another input. This allows you to combine the two files into a single output, one after the other.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
SelectorType
— (String
) Specifies the type of the audio selector. Possible values include:"PID"
"TRACK"
"LANGUAGE_CODE"
Tracks
— (Array<Integer>
) Identify a track from the input audio to include in this selector by entering the track index number. To include several tracks in a single audio selector, specify multiple tracks as follows. Using the console, enter a comma-separated list. For examle, type "1,2,3" to include tracks 1 through 3. Specifying directly in your JSON job file, provide the track numbers in an array. For example, "tracks": [1,2,3].
CaptionSelectors
— (map<map>
) Use Captions selectors (CaptionSelectors) to specify the captions data from the input that you will use in your outputs. You can use mutiple captions selectors per input.CustomLanguageCode
— (String
) The specific language to extract from source, using the ISO 639-2 or ISO 639-3 three-letter language code. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions.LanguageCode
— (String
) The specific language to extract from source. If input is SCTE-27, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub and output is Burn-in or SMPTE-TT, complete this field and/or PID to select the caption language to extract. If input is DVB-Sub that is being passed through, omit this field (and PID field); there is no way to extract a specific language with pass-through captions. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
SourceSettings
— (map
) Source settings (SourceSettings) contains the group of settings for captions in the input.AncillarySourceSettings
— (map
) Settings for ancillary captions source.SourceAncillaryChannelNumber
— (Integer
) Specifies the 608 channel number in the ancillary data track from which to extract captions. Unused for passthrough.
DvbSubSourceSettings
— (map
) DVB Sub Source SettingsPid
— (Integer
) When using DVB-Sub with Burn-In or SMPTE-TT, use this PID for the source content. Unused for DVB-Sub passthrough. All DVB-Sub content is passed through, regardless of selectors.
EmbeddedSourceSettings
— (map
) Settings for embedded captions SourceConvert608To708
— (String
) When set to UPCONVERT, 608 data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
Source608ChannelNumber
— (Integer
) Specifies the 608/708 channel number within the video track from which to extract captions. Unused for passthrough.Source608TrackNumber
— (Integer
) Specifies the video track index used for extracting captions. The system only supports one input video track, so this should always be set to '1'.
FileSourceSettings
— (map
) Settings for File-based Captions in SourceConvert608To708
— (String
) If set to UPCONVERT, 608 caption data is both passed through via the "608 compatibility bytes" fields of the 708 wrapper as well as translated into 708. 708 data present in the source content will be discarded. Possible values include:"UPCONVERT"
"DISABLED"
SourceFile
— (String
) External caption file used for loading captions. Accepted file extensions are 'scc', 'ttml', 'dfxp', 'stl', 'srt', and 'smi'.TimeDelta
— (Integer
) Specifies a time delta in seconds to offset the captions from the source file.
SourceType
— (String
) Use Source (SourceType) to identify the format of your input captions. The service cannot auto-detect caption format. Possible values include:"ANCILLARY"
"DVB_SUB"
"EMBEDDED"
"SCTE20"
"SCC"
"TTML"
"STL"
"SRT"
"SMI"
"TELETEXT"
"NULL_SOURCE"
"IMSC"
TeletextSourceSettings
— (map
) Settings specific to Teletext caption sources, including Page number.PageNumber
— (String
) Use Page Number (PageNumber) to specify the three-digit hexadecimal page number that will be used for Teletext captions. Do not use this setting if you are passing through teletext from the input source to output.
TrackSourceSettings
— (map
) Settings specific to caption sources that are specfied by track number. Sources include IMSC in IMF.TrackNumber
— (Integer
) Use this setting to select a single captions track from a source. Track numbers correspond to the order in the captions source file. For IMF sources, track numbering is based on the order that the captions appear in the CPL. For example, use 1 to select the captions asset that is listed first in the CPL. To include more than one captions track in your job outputs, create multiple input captions selectors. Specify one track per selector.
DeblockFilter
— (String
) Enable Deblock (InputDeblockFilter) to produce smoother motion in the output. Default is disabled. Only manaully controllable for MPEG2 and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
DenoiseFilter
— (String
) Enable Denoise (InputDenoiseFilter) to filter noise from the input. Default is disabled. Only applicable to MPEG2, H.264, H.265, and uncompressed video inputs. Possible values include:"ENABLED"
"DISABLED"
FilterEnable
— (String
) Use Filter enable (InputFilterEnable) to specify how the transcoding service applies the denoise and deblock filters. You must also enable the filters separately, with Denoise (InputDenoiseFilter) and Deblock (InputDeblockFilter). * Auto - The transcoding service determines whether to apply filtering, depending on input type and quality. * Disable - The input is not filtered. This is true even if you use the API to enable them in (InputDeblockFilter) and (InputDeblockFilter). * Force - The in put is filtered regardless of input type. Possible values include:"AUTO"
"DISABLE"
"FORCE"
FilterStrength
— (Integer
) Use Filter strength (FilterStrength) to adjust the magnitude the input filter settings (Deblock and Denoise). The range is -5 to 5. Default is 0.ImageInserter
— (map
) Enable the image inserter feature to include a graphic overlay on your video. Enable or disable this feature for each input individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
InputClippings
— (Array<map>
) (InputClippings) contains sets of start and end times that together specify a portion of the input to be used in the outputs. If you provide only a start time, the clip will be the entire input from that point to the end. If you provide only an end time, it will be the entire input up to that point. When you specify more than one input clip, the transcoding service creates the job outputs by stringing the clips together in the order you specify them.EndTimecode
— (String
) Set End timecode (EndTimecode) to the end of the portion of the input you are clipping. The frame corresponding to the End timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for timecode source under input settings (InputTimecodeSource). For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to end six minutes into the video, use 01:06:00:00.StartTimecode
— (String
) Set Start timecode (StartTimecode) to the beginning of the portion of the input you are clipping. The frame corresponding to the Start timecode value is included in the clip. Start timecode or End timecode may be left blank, but not both. Use the format HH:MM:SS:FF or HH:MM:SS;FF, where HH is the hour, MM is the minute, SS is the second, and FF is the frame number. When choosing this value, take into account your setting for Input timecode source. For example, if you have embedded timecodes that start at 01:00:00:00 and you want your clip to begin five minutes into the video, use 01:05:00:00.
ProgramNumber
— (Integer
) Use Program (programNumber) to select a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported. Default is the first program within the transport stream. If the program you specify doesn't exist, the transcoding service will use this default.PsiControl
— (String
) Set PSI control (InputPsiControl) for transport stream inputs to specify which data the demux process to scans. * Ignore PSI - Scan all PIDs for audio and video. * Use PSI - Scan only PSI data. Possible values include:"IGNORE_PSI"
"USE_PSI"
TimecodeSource
— (String
) Timecode source under input settings (InputTimecodeSource) only affects the behavior of features that apply to a single input at a time, such as input clipping and synchronizing some captions formats. Use this setting to specify whether the service counts frames by timecodes embedded in the video (EMBEDDED) or by starting the first frame at zero (ZEROBASED). In both cases, the timecode format is HH:MM:SS:FF or HH:MM:SS;FF, where FF is the frame number. Only set this to EMBEDDED if your source video has embedded timecodes. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
VideoSelector
— (map
) Selector for video.ColorSpace
— (String
) If your input video has accurate color space metadata, or if you don't know about color space, leave this set to the default value FOLLOW. The service will automatically detect your input color space. If your input video has metadata indicating the wrong color space, or if your input video is missing color space metadata that should be there, specify the accurate color space here. If you choose HDR10, you can also correct inaccurate color space coefficients, using the HDR master display information controls. You must also set Color space usage (ColorSpaceUsage) to FORCE for the service to use these values. Possible values include:"FOLLOW"
"REC_601"
"REC_709"
"HDR10"
"HLG_2020"
ColorSpaceUsage
— (String
) There are two sources for color metadata, the input file and the job configuration (in the Color space and HDR master display informaiton settings). The Color space usage setting controls which takes precedence. FORCE: The system will use color metadata supplied by user, if any. If the user does not supply color metadata, the system will use data from the source. FALLBACK: The system will use color metadata from the source. If source has no color metadata, the system will use user-supplied color metadata values if available. Possible values include:"FORCE"
"FALLBACK"
Hdr10Metadata
— (map
) Use the "HDR master display information" (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. These values vary depending on the input video and must be provided by a color grader. Range is 0 to 50,000; each increment represents 0.00002 in CIE1931 color coordinate. Note that these settings are not color correction. Note that if you are creating HDR outputs inside of an HLS CMAF package, to comply with the Apple specification, you must use the following settings. Set "MP4 packaging type" (writeMp4PackagingType) to HVC1 (HVC1). Set "Profile" (H265Settings > codecProfile) to Main10/High (MAIN10_HIGH). Set "Level" (H265Settings > codecLevel) to 5 (LEVEL_5).BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Pid
— (Integer
) Use PID (Pid) to select specific video data from an input file. Specify this value as an integer; the system automatically converts it to the hexidecimal value. For example, 257 selects PID 0x101. A PID, or packet identifier, is an identifier for a set of data in an MPEG-2 transport stream container.ProgramNumber
— (Integer
) Selects a specific program from within a multi-program transport stream. Note that Quad 4K is not currently supported.Rotate
— (String
) Use Rotate (InputRotate) to specify how the service rotates your video. You can choose automatic rotation or specify a rotation. You can specify a clockwise rotation of 0, 90, 180, or 270 degrees. If your input video container is .mov or .mp4 and your input has rotation metadata, you can choose Automatic to have the service rotate your video according to the rotation specified in the metadata. The rotation must be within one degree of 90, 180, or 270 degrees. If the rotation metadata specifies any other rotation, the service will default to no rotation. By default, the service does no rotation, even if your input video has rotation metadata. The service doesn't pass through rotation metadata. Possible values include:"DEGREE_0"
"DEGREES_90"
"DEGREES_180"
"DEGREES_270"
"AUTO"
MotionImageInserter
— (map
) Overlay motion graphics on top of your video. The motion graphics that you specify here appear on all outputs in all output groups.Framerate
— (map
) If your motion graphic asset is a .mov file, keep this setting unspecified. If your motion graphic asset is a series of .png files, specify the frame rate of the overlay in frames per second, as a fraction. For example, specify 24 fps as 24/1. Make sure that the number of images in your series matches the frame rate and your intended overlay duration. For example, if you want a 30-second overlay at 30 fps, you should have 900 .png images. This overlay frame rate doesn't need to match the frame rate of the underlying video.FramerateDenominator
— (Integer
) The bottom of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 1.FramerateNumerator
— (Integer
) The top of the fraction that expresses your overlay frame rate. For example, if your frame rate is 24 fps, set this value to 24.
Input
— (String
) Specify the .mov file or series of .png files that you want to overlay on your video. For .png files, provide the file name of the first file in the series. Make sure that the names of the .png files end with sequential numbers that specify the order that they are played in. For example, overlay_000.png, overlay_001.png, overlay_002.png, and so on. The sequence must start at zero, and each image file name must have the same number of digits. Pad your initial file names with enough zeros to complete the sequence. For example, if the first image is overlay_0.png, there can be only 10 images in the sequence, with the last image being overlay_9.png. But if the first image is overlay_00.png, there can be 100 images in the sequence.InsertionMode
— (String
) Choose the type of motion graphic asset that you are providing for your overlay. You can choose either a .mov file or a series of .png files. Possible values include:"MOV"
"PNG"
Offset
— (map
) Use Offset to specify the placement of your motion graphic overlay on the video frame. Specify in pixels, from the upper-left corner of the frame. If you don't specify an offset, the service scales your overlay to the full size of the frame. Otherwise, the service inserts the overlay at its native resolution and scales the size up or down with any video scaling.ImageX
— (Integer
) Set the distance, in pixels, between the overlay and the left edge of the video frame.ImageY
— (Integer
) Set the distance, in pixels, between the overlay and the top edge of the video frame.
Playback
— (String
) Specify whether your motion graphic overlay repeats on a loop or plays only once. Possible values include:"ONCE"
"REPEAT"
StartTime
— (String
) Specify when the motion overlay begins. Use timecode format (HH:MM:SS:FF or HH:MM:SS;FF). Make sure that the timecode you provide here takes into account how you have set up your timecode configuration under both job settings and input settings. The simplest way to do that is to set both to start at 0. If you need to set up your job to follow timecodes embedded in your source that don't start at zero, make sure that you specify a start time that is after the first embedded timecode. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/setting-up-timecode.html Find job-wide and input timecode configuration settings in your JSON job settings specification at settings>timecodeConfig>source and settings>inputs>timecodeSource.
NielsenConfiguration
— (map
) Settings for Nielsen ConfigurationBreakoutCode
— (Integer
) Use Nielsen Configuration (NielsenConfiguration) to set the Nielsen measurement system breakout code. Supported values are 0, 3, 7, and 9.DistributorId
— (String
) Use Distributor ID (DistributorID) to specify the distributor ID that is assigned to your organization by Neilsen.
OutputGroups
— (Array<map>
) (OutputGroups) contains one group of settings for each set of outputs that share a common package type. All unpackaged files (MPEG-4, MPEG-2 TS, Quicktime, MXF, and no container) are grouped in a single output group as well. Required in (OutputGroups) is a group of settings that apply to the whole group. This required object depends on the value you set for (Type) under (OutputGroups)>(OutputGroupSettings). Type, settings object pairs are as follows. * FILE_GROUP_SETTINGS, FileGroupSettings * HLS_GROUP_SETTINGS, HlsGroupSettings * DASH_ISO_GROUP_SETTINGS, DashIsoGroupSettings * MS_SMOOTH_GROUP_SETTINGS, MsSmoothGroupSettings * CMAF_GROUP_SETTINGS, CmafGroupSettingsCustomName
— (String
) Use Custom Group Name (CustomName) to specify a name for the output group. This value is displayed on the console and can make your job settings JSON more human-readable. It does not affect your outputs. Use up to twelve characters that are either letters, numbers, spaces, or underscores.Name
— (String
) Name of the output groupOutputGroupSettings
— (map
) Output Group settings, including typeCmafGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to CMAF_GROUP_SETTINGS. Each output in a CMAF Output Group may only contain a single video, audio, or caption output.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"STATIC_KEY"
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Use this setting to specify the length, in seconds, of each individual CMAF segment. This value applies to the whole package; that is, to every output in the output group. Note that segments end on the first keyframe after this number of seconds, so the actual segment length might be slightly longer. If you set Segment control (CmafSegmentControl) to single file, the service puts the content of each output in a single file that has metadata that marks these segments. If you set it to segmented files, the service creates multiple files for each output, each with the content of one segment.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
WriteDashManifest
— (String
) When set to ENABLED, a DASH MPD manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
WriteHlsManifest
— (String
) When set to ENABLED, an Apple HLS manifest will be generated for this output. Possible values include:"DISABLED"
"ENABLED"
DashIsoGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to DASH_ISO_GROUP_SETTINGS.BaseUrl
— (String
) A partial URI prefix that will be put in the manifest (.mpd) file at the top level BaseURL element. Can be used if streams are delivered from a different URL than the manifest file.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) DRM settings.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Length of fragments to generate (in seconds). Fragment length must be compatible with GOP size and Framerate. Note that fragments will end on the next keyframe after this number of seconds, so actual fragment length may be longer. When Emit Single File is checked, the fragmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.HbbtvCompliance
— (String
) Supports HbbTV specification as indicated Possible values include:"HBBTV_1_5"
"NONE"
MinBufferTime
— (Integer
) Minimum time of initially buffered media that is needed to ensure smooth playout.SegmentControl
— (String
) When set to SINGLE_FILE, a single output file is generated, which is internally segmented using the Fragment Length and Segment Length. When set to SEGMENTED_FILES, separate segment files will be created. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of mpd segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer. When Emit Single File is checked, the segmentation is internal to a single output file and it does not cause the creation of many output files as in other output types.WriteSegmentTimelineInRepresentation
— (String
) When you enable Precise segment duration in manifests (writeSegmentTimelineInRepresentation), your DASH manifest shows precise segment durations. The segment duration information appears inside the SegmentTimeline element, inside SegmentTemplate at the Representation level. When this feature isn't enabled, the segment durations in your DASH manifest are approximate. The segment duration information appears in the duration attribute of the SegmentTemplate element. Possible values include:"ENABLED"
"DISABLED"
FileGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to FILE_GROUP_SETTINGS.Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
HlsGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to HLS_GROUP_SETTINGS.AdMarkers
— (Array<String>
) Choose one or more ad marker types to pass SCTE35 signals through to this group of Apple HLS outputs.BaseUrl
— (String
) A partial URI prefix that will be prepended to each output in the media .m3u8 file. Can be used if base manifest is delivered from a different URL than the main .m3u8 file.CaptionLanguageMappings
— (Array<map>
) Language to be used on Caption outputsCaptionChannel
— (Integer
) Caption channel.CustomLanguageCode
— (String
) Specify the language for this caption channel, using the ISO 639-2 or ISO 639-3 three-letter language codeLanguageCode
— (String
) Specify the language, using the ISO 639-2 three-letter code listed at https://www.loc.gov/standards/iso639-2/php/code_list.php. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Caption language description.
CaptionLanguageSetting
— (String
) Applies only to 608 Embedded output captions. Insert: Include CLOSED-CAPTIONS lines in the manifest. Specify at least one language in the CC1 Language Code field. One CLOSED-CAPTION line is added for each Language Code you specify. Make sure to specify the languages in the order in which they appear in the original source (if the source is embedded format) or the order of the caption selectors (if the source is other than embedded). Otherwise, languages in the manifest will not match up properly with the output captions. None: Include CLOSED-CAPTIONS=NONE line in the manifest. Omit: Omit any CLOSED-CAPTIONS line from the manifest. Possible values include:"INSERT"
"OMIT"
"NONE"
ClientCache
— (String
) When set to ENABLED, sets #EXT-X-ALLOW-CACHE:no tag, which prevents client from saving media segments for later replay. Possible values include:"DISABLED"
"ENABLED"
CodecSpecification
— (String
) Specification to use (RFC-6381 or the default RFC-4281) during m3u8 playlist generation. Possible values include:"RFC_6381"
"RFC_4281"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
DirectoryStructure
— (String
) Indicates whether segments should be placed in subdirectories. Possible values include:"SINGLE_DIRECTORY"
"SUBDIRECTORY_PER_STREAM"
Encryption
— (map
) DRM settings.ConstantInitializationVector
— (String
) This is a 128-bit, 16-byte hex value represented by a 32-character text string. If this parameter is not set then the Initialization Vector will follow the segment number by default.EncryptionMethod
— (String
) Encrypts the segments with the given encryption scheme. Leave blank to disable. Selecting 'Disabled' in the web interface also disables encryption. Possible values include:"AES128"
"SAMPLE_AES"
InitializationVectorInManifest
— (String
) The Initialization Vector is a 128-bit number used in conjunction with the key for encrypting blocks. If set to INCLUDE, Initialization Vector is listed in the manifest. Otherwise Initialization Vector is not in the manifest. Possible values include:"INCLUDE"
"EXCLUDE"
OfflineEncrypted
— (String
) Enable this setting to insert the EXT-X-SESSION-KEY element into the master playlist. This allows for offline Apple HLS FairPlay content protection. Possible values include:"ENABLED"
"DISABLED"
SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
StaticKeyProvider
— (map
) Use these settings to set up encryption with a static key provider.KeyFormat
— (String
) Relates to DRM implementation. Sets the value of the KEYFORMAT attribute. Must be 'identity' or a reverse DNS string. May be omitted to indicate an implicit value of 'identity'.KeyFormatVersions
— (String
) Relates to DRM implementation. Either a single positive integer version value or a slash delimited list of version values (1/2/3).StaticKeyValue
— (String
) Relates to DRM implementation. Use a 32-character hexidecimal string to specify Key Value (StaticKeyValue).Url
— (String
) Relates to DRM implementation. The location of the license server used for protecting content.
Type
— (String
) Indicates which type of key provider is used for encryption. Possible values include:"SPEKE"
"STATIC_KEY"
ManifestCompression
— (String
) When set to GZIP, compresses HLS playlist. Possible values include:"GZIP"
"NONE"
ManifestDurationFormat
— (String
) Indicates whether the output manifest should use floating point values for segment duration. Possible values include:"FLOATING_POINT"
"INTEGER"
MinFinalSegmentLength
— (Float
) Keep this setting at the default value of 0, unless you are troubleshooting a problem with how devices play back the end of your video asset. If you know that player devices are hanging on the final segment of your video because the length of your final segment is too short, use this setting to specify a minimum final segment length, in seconds. Choose a value that is greater than or equal to 1 and less than your segment length. When you specify a value for this setting, the encoder will combine any final segment that is shorter than the length that you specify with the previous segment. For example, your segment length is 3 seconds and your final segment is .5 seconds without a minimum final segment length; when you set the minimum final segment length to 1, your final segment is 3.5 seconds.MinSegmentLength
— (Integer
) When set, Minimum Segment Size is enforced by looking ahead and back within the specified range for a nearby avail and extending the segment size if needed.OutputSelection
— (String
) Indicates whether the .m3u8 manifest file should be generated for this HLS output group. Possible values include:"MANIFESTS_AND_SEGMENTS"
"SEGMENTS_ONLY"
ProgramDateTime
— (String
) Includes or excludes EXT-X-PROGRAM-DATE-TIME tag in .m3u8 manifest files. The value is calculated as follows: either the program date and time are initialized using the input timecode source, or the time is initialized using the input timecode source and the date is initialized using the timestamp_offset. Possible values include:"INCLUDE"
"EXCLUDE"
ProgramDateTimePeriod
— (Integer
) Period of insertion of EXT-X-PROGRAM-DATE-TIME entry, in seconds.SegmentControl
— (String
) When set to SINGLE_FILE, emits program as a single media resource (.ts) file, uses #EXT-X-BYTERANGE tags to index segment for playback. Possible values include:"SINGLE_FILE"
"SEGMENTED_FILES"
SegmentLength
— (Integer
) Length of MPEG-2 Transport Stream segments to create (in seconds). Note that segments will end on the next keyframe after this number of seconds, so actual segment length may be longer.SegmentsPerSubdirectory
— (Integer
) Number of segments to write to a subdirectory before starting a new one. directoryStructure must be SINGLE_DIRECTORY for this setting to have an effect.StreamInfResolution
— (String
) Include or exclude RESOLUTION attribute for video in EXT-X-STREAM-INF tag of variant manifest. Possible values include:"INCLUDE"
"EXCLUDE"
TimedMetadataId3Frame
— (String
) Indicates ID3 frame that has the timecode. Possible values include:"NONE"
"PRIV"
"TDRL"
TimedMetadataId3Period
— (Integer
) Timed Metadata interval in seconds.TimestampDeltaMilliseconds
— (Integer
) Provides an extra millisecond delta offset to fine tune the timestamps.
MsSmoothGroupSettings
— (map
) Required when you set (Type) under (OutputGroups)>(OutputGroupSettings) to MS_SMOOTH_GROUP_SETTINGS.AudioDeduplication
— (String
) COMBINE_DUPLICATE_STREAMS combines identical audio encoding settings across a Microsoft Smooth output group into a single audio stream. Possible values include:"COMBINE_DUPLICATE_STREAMS"
"NONE"
Destination
— (String
) Use Destination (Destination) to specify the S3 output location and the output filename base. Destination accepts format identifiers. If you do not specify the base filename in the URI, the service will use the filename of the input file. If your job has multiple inputs, the service uses the filename of the first input file.DestinationSettings
— (map
) Settings associated with the destination. Will vary based on the type of destinationS3Settings
— (map
) Settings associated with S3 destinationEncryption
— (map
) Settings for how your job outputs are encrypted as they are uploaded to Amazon S3.EncryptionType
— (String
) Specify how you want your data keys managed. AWS uses data keys to encrypt your content. AWS also encrypts the data keys themselves, using a customer master key (CMK), and then stores the encrypted data keys alongside your encrypted content. Use this setting to specify which AWS service manages the CMK. For simplest set up, choose Amazon S3 (SERVER_SIDE_ENCRYPTION_S3). If you want your master key to be managed by AWS Key Management Service (KMS), choose AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). By default, when you choose AWS KMS, KMS uses the AWS managed customer master key (CMK) associated with Amazon S3 to encrypt your data keys. You can optionally choose to specify a different, customer managed CMK. Do so by specifying the Amazon Resource Name (ARN) of the key for the setting KMS ARN (kmsKeyArn). Possible values include:"SERVER_SIDE_ENCRYPTION_S3"
"SERVER_SIDE_ENCRYPTION_KMS"
KmsKeyArn
— (String
) Optionally, specify the customer master key (CMK) that you want to use to encrypt the data key that AWS uses to encrypt your output content. Enter the Amazon Resource Name (ARN) of the CMK. To use this setting, you must also set Server-side encryption (S3ServerSideEncryptionType) to AWS KMS (SERVER_SIDE_ENCRYPTION_KMS). If you set Server-side encryption to AWS KMS but don't specify a CMK here, AWS uses the AWS managed CMK associated with Amazon S3.
Encryption
— (map
) If you are using DRM, set DRM System (MsSmoothEncryptionSettings) to specify the value SpekeKeyProvider.SpekeKeyProvider
— (map
) Settings for use with a SPEKE key providerCertificateArn
— (String
) Optional AWS Certificate Manager ARN for a certificate to send to the keyprovider. The certificate holds a key used by the keyprovider to encrypt the keys in its response.ResourceId
— (String
) The SPEKE-compliant server uses Resource ID (ResourceId) to identify content.SystemIds
— (Array<String>
) Relates to SPEKE implementation. DRM system identifiers. DASH output groups support a max of two system ids. Other group types support one system id.Url
— (String
) Use URL (Url) to specify the SPEKE-compliant server that will provide keys for content.
FragmentLength
— (Integer
) Use Fragment length (FragmentLength) to specify the mp4 fragment sizes in seconds. Fragment length must be compatible with GOP size and frame rate.ManifestEncoding
— (String
) Use Manifest encoding (MsSmoothManifestEncoding) to specify the encoding format for the server and client manifest. Valid options are utf8 and utf16. Possible values include:"UTF8"
"UTF16"
Type
— (String
) Type of output group (File group, Apple HLS, DASH ISO, Microsoft Smooth Streaming, CMAF) Possible values include:"HLS_GROUP_SETTINGS"
"DASH_ISO_GROUP_SETTINGS"
"FILE_GROUP_SETTINGS"
"MS_SMOOTH_GROUP_SETTINGS"
"CMAF_GROUP_SETTINGS"
Outputs
— (Array<map>
) This object holds groups of encoding settings, one group of settings per output.AudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) (CaptionDescriptions) contains groups of captions settings. For each output that has captions, include one instance of (CaptionDescriptions). (CaptionDescriptions) can contain multiple groups of captions settings.CaptionSelectorName
— (String
) Specifies which "Caption Selector":#inputs-caption_selector to use from each input when generating captions. The name should be of the format "Caption Selector", which denotes that the Nth Caption Selector will be used from each input. CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
Extension
— (String
) Use Extension (Extension) to specify the file extension for outputs in File output groups. If you do not specify a value, the service will use default extensions by container type as follows * MPEG-2 transport stream, m2ts * Quicktime, mov * MXF container, mxf * MPEG-4 container, mp4 * No Container, the service will use codec extensions (e.g. AAC, H265, H265, AC3)NameModifier
— (String
) Use Name modifier (NameModifier) to have the service add a string to the end of each output filename. You specify the base filename as part of your destination URI. When you create multiple outputs in the same output group, Name modifier (NameModifier) is required. Name modifier also accepts format identifiers. For DASH ISO outputs, if you use the format identifiers $Number$ or $Time$ in one output, you must use them in the same way in all outputs of the output group.OutputSettings
— (map
) Specific settings for this type of output.HlsSettings
— (map
) Settings for HLS output groupsAudioGroupId
— (String
) Specifies the group to which the audio Rendition belongs.AudioRenditionSets
— (String
) List all the audio groups that are used with the video output stream. Input all the audio GROUP-IDs that are associated to the video, separate by ','.AudioTrackType
— (String
) Four types of audio-only tracks are supported: Audio-Only Variant Stream The client can play back this audio-only stream instead of video in low-bandwidth scenarios. Represented as an EXT-X-STREAM-INF in the HLS manifest. Alternate Audio, Auto Select, Default Alternate rendition that the client should try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=YES, AUTOSELECT=YES Alternate Audio, Auto Select, Not Default Alternate rendition that the client may try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=YES Alternate Audio, not Auto Select Alternate rendition that the client will not try to play back by default. Represented as an EXT-X-MEDIA in the HLS manifest with DEFAULT=NO, AUTOSELECT=NO Possible values include:"ALTERNATE_AUDIO_AUTO_SELECT_DEFAULT"
"ALTERNATE_AUDIO_AUTO_SELECT"
"ALTERNATE_AUDIO_NOT_AUTO_SELECT"
"AUDIO_ONLY_VARIANT_STREAM"
IFrameOnlyManifest
— (String
) When set to INCLUDE, writes I-Frame Only Manifest in addition to the HLS manifest Possible values include:"INCLUDE"
"EXCLUDE"
SegmentModifier
— (String
) String concatenated to end of segment filenames. Accepts "Format Identifiers":#format_identifier_parameters.
Preset
— (String
) Use Preset (Preset) to specifiy a preset for your transcoding settings. Provide the system or custom preset name. You can specify either Preset (Preset) or Container settings (ContainerSettings), but not both.VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
TimecodeConfig
— (map
) Contains settings used to acquire and adjust timecode information from inputs.Anchor
— (String
) If you use an editing platform that relies on an anchor timecode, use Anchor Timecode (Anchor) to specify a timecode that will match the input video frame to the output video frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF). This setting ignores frame rate conversion. System behavior for Anchor Timecode varies depending on your setting for Source (TimecodeSource). * If Source (TimecodeSource) is set to Specified Start (SPECIFIEDSTART), the first input frame is the specified value in Start Timecode (Start). Anchor Timecode (Anchor) and Start Timecode (Start) are used calculate output timecode. * If Source (TimecodeSource) is set to Start at 0 (ZEROBASED) the first frame is 00:00:00:00. * If Source (TimecodeSource) is set to Embedded (EMBEDDED), the first frame is the timecode value on the first input frame of the input.Source
— (String
) Use Source (TimecodeSource) to set how timecodes are handled within this job. To make sure that your video, audio, captions, and markers are synchronized and that time-based features, such as image inserter, work correctly, choose the Timecode source option that matches your assets. All timecodes are in a 24-hour format with frame number (HH:MM:SS:FF). * Embedded (EMBEDDED) - Use the timecode that is in the input video. If no embedded timecode is in the source, the service will use Start at 0 (ZEROBASED) instead. * Start at 0 (ZEROBASED) - Set the timecode of the initial frame to 00:00:00:00. * Specified Start (SPECIFIEDSTART) - Set the timecode of the initial frame to a value other than zero. You use Start timecode (Start) to provide this value. Possible values include:"EMBEDDED"
"ZEROBASED"
"SPECIFIEDSTART"
Start
— (String
) Only use when you set Source (TimecodeSource) to Specified start (SPECIFIEDSTART). Use Start timecode (Start) to specify the timecode for the initial frame. Use 24-hour format with frame number, (HH:MM:SS:FF) or (HH:MM:SS;FF).TimestampOffset
— (String
) Only applies to outputs that support program-date-time stamp. Use Timestamp offset (TimestampOffset) to overwrite the timecode date without affecting the time and frame number. Provide the new date as a string in the format "yyyy-mm-dd". To use Time stamp offset, you must also enable Insert program-date-time (InsertProgramDateTime) in the output settings. For example, if the date part of your timecodes is 2002-1-25 and you want to change it to one year later, set Timestamp offset (TimestampOffset) to 2003-1-25.
TimedMetadataInsertion
— (map
) Enable Timed metadata insertion (TimedMetadataInsertion) to include ID3 tags in your job. To include timed metadata, you must enable it here, enable it in each output container, and specify tags and timecodes in ID3 insertion (Id3Insertion) objects.Id3Insertions
— (Array<map>
) Id3Insertions contains the array of Id3Insertion instances.Id3
— (String
) Use ID3 tag (Id3) to provide a tag value in base64-encode format.Timecode
— (String
) Provide a Timecode (TimeCode) in HH:MM:SS:FF or HH:MM:SS;FF format.
StatusUpdateInterval
— (String
) Specify how often MediaConvert sends STATUS_UPDATE events to Amazon CloudWatch Events. Set the interval, in seconds, between status updates. MediaConvert sends an update at this interval from the time the service begins processing your job to the time it completes the transcode or encounters an error. Possible values include:"SECONDS_10"
"SECONDS_12"
"SECONDS_15"
"SECONDS_20"
"SECONDS_30"
"SECONDS_60"
"SECONDS_120"
"SECONDS_180"
"SECONDS_240"
"SECONDS_300"
"SECONDS_360"
"SECONDS_420"
"SECONDS_480"
"SECONDS_540"
"SECONDS_600"
Type
— (String
) A job template can be of two types: system or custom. System or built-in job templates can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
updatePreset(params = {}, callback) ⇒ AWS.Request
Modify one of your existing presets.
Service Reference:
Examples:
Calling the updatePreset operation
var params = {
Name: 'STRING_VALUE', /* required */
Category: 'STRING_VALUE',
Description: 'STRING_VALUE',
Settings: {
AudioDescriptions: [
{
AudioNormalizationSettings: {
Algorithm: ITU_BS_1770_1 | ITU_BS_1770_2,
AlgorithmControl: CORRECT_AUDIO | MEASURE_ONLY,
CorrectionGateLevel: 'NUMBER_VALUE',
LoudnessLogging: LOG | DONT_LOG,
PeakCalculation: TRUE_PEAK | NONE,
TargetLkfs: 'NUMBER_VALUE'
},
AudioSourceName: 'STRING_VALUE',
AudioType: 'NUMBER_VALUE',
AudioTypeControl: FOLLOW_INPUT | USE_CONFIGURED,
CodecSettings: {
AacSettings: {
AudioDescriptionBroadcasterMix: BROADCASTER_MIXED_AD | NORMAL,
Bitrate: 'NUMBER_VALUE',
CodecProfile: LC | HEV1 | HEV2,
CodingMode: AD_RECEIVER_MIX | CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_5_1,
RateControlMode: CBR | VBR,
RawFormat: LATM_LOAS | NONE,
SampleRate: 'NUMBER_VALUE',
Specification: MPEG2 | MPEG4,
VbrQuality: LOW | MEDIUM_LOW | MEDIUM_HIGH | HIGH
},
Ac3Settings: {
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | DIALOGUE | EMERGENCY | HEARING_IMPAIRED | MUSIC_AND_EFFECTS | VISUALLY_IMPAIRED | VOICE_OVER,
CodingMode: CODING_MODE_1_0 | CODING_MODE_1_1 | CODING_MODE_2_0 | CODING_MODE_3_2_LFE,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionProfile: FILM_STANDARD | NONE,
LfeFilter: ENABLED | DISABLED,
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
SampleRate: 'NUMBER_VALUE'
},
AiffSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
Codec: AAC | MP2 | WAV | AIFF | AC3 | EAC3 | PASSTHROUGH,
Eac3Settings: {
AttenuationControl: ATTENUATE_3_DB | NONE,
Bitrate: 'NUMBER_VALUE',
BitstreamMode: COMPLETE_MAIN | COMMENTARY | EMERGENCY | HEARING_IMPAIRED | VISUALLY_IMPAIRED,
CodingMode: CODING_MODE_1_0 | CODING_MODE_2_0 | CODING_MODE_3_2,
DcFilter: ENABLED | DISABLED,
Dialnorm: 'NUMBER_VALUE',
DynamicRangeCompressionLine: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
DynamicRangeCompressionRf: NONE | FILM_STANDARD | FILM_LIGHT | MUSIC_STANDARD | MUSIC_LIGHT | SPEECH,
LfeControl: LFE | NO_LFE,
LfeFilter: ENABLED | DISABLED,
LoRoCenterMixLevel: 'NUMBER_VALUE',
LoRoSurroundMixLevel: 'NUMBER_VALUE',
LtRtCenterMixLevel: 'NUMBER_VALUE',
LtRtSurroundMixLevel: 'NUMBER_VALUE',
MetadataControl: FOLLOW_INPUT | USE_CONFIGURED,
PassthroughControl: WHEN_POSSIBLE | NO_PASSTHROUGH,
PhaseControl: SHIFT_90_DEGREES | NO_SHIFT,
SampleRate: 'NUMBER_VALUE',
StereoDownmix: NOT_INDICATED | LO_RO | LT_RT | DPL2,
SurroundExMode: NOT_INDICATED | ENABLED | DISABLED,
SurroundMode: NOT_INDICATED | ENABLED | DISABLED
},
Mp2Settings: {
Bitrate: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
SampleRate: 'NUMBER_VALUE'
},
WavSettings: {
BitDepth: 'NUMBER_VALUE',
Channels: 'NUMBER_VALUE',
Format: RIFF | RF64,
SampleRate: 'NUMBER_VALUE'
}
},
CustomLanguageCode: 'STRING_VALUE',
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageCodeControl: FOLLOW_INPUT | USE_CONFIGURED,
RemixSettings: {
ChannelMapping: {
OutputChannels: [
{
InputChannels: [
'NUMBER_VALUE',
/* more items */
]
},
/* more items */
]
},
ChannelsIn: 'NUMBER_VALUE',
ChannelsOut: 'NUMBER_VALUE'
},
StreamName: 'STRING_VALUE'
},
/* more items */
],
CaptionDescriptions: [
{
CustomLanguageCode: 'STRING_VALUE',
DestinationSettings: {
BurninDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
DestinationType: BURN_IN | DVB_SUB | EMBEDDED | EMBEDDED_PLUS_SCTE20 | SCTE20_PLUS_EMBEDDED | SCC | SRT | SMI | TELETEXT | TTML | WEBVTT,
DvbSubDestinationSettings: {
Alignment: CENTERED | LEFT,
BackgroundColor: NONE | BLACK | WHITE,
BackgroundOpacity: 'NUMBER_VALUE',
FontColor: WHITE | BLACK | YELLOW | RED | GREEN | BLUE,
FontOpacity: 'NUMBER_VALUE',
FontResolution: 'NUMBER_VALUE',
FontScript: AUTOMATIC | HANS | HANT,
FontSize: 'NUMBER_VALUE',
OutlineColor: BLACK | WHITE | YELLOW | RED | GREEN | BLUE,
OutlineSize: 'NUMBER_VALUE',
ShadowColor: NONE | BLACK | WHITE,
ShadowOpacity: 'NUMBER_VALUE',
ShadowXOffset: 'NUMBER_VALUE',
ShadowYOffset: 'NUMBER_VALUE',
TeletextSpacing: FIXED_GRID | PROPORTIONAL,
XPosition: 'NUMBER_VALUE',
YPosition: 'NUMBER_VALUE'
},
EmbeddedDestinationSettings: {
Destination608ChannelNumber: 'NUMBER_VALUE'
},
SccDestinationSettings: {
Framerate: FRAMERATE_23_97 | FRAMERATE_24 | FRAMERATE_29_97_DROPFRAME | FRAMERATE_29_97_NON_DROPFRAME
},
TeletextDestinationSettings: {
PageNumber: 'STRING_VALUE'
},
TtmlDestinationSettings: {
StylePassthrough: ENABLED | DISABLED
}
},
LanguageCode: ENG | SPA | FRA | DEU | GER | ZHO | ARA | HIN | JPN | RUS | POR | ITA | URD | VIE | KOR | PAN | ABK | AAR | AFR | AKA | SQI | AMH | ARG | HYE | ASM | AVA | AVE | AYM | AZE | BAM | BAK | EUS | BEL | BEN | BIH | BIS | BOS | BRE | BUL | MYA | CAT | KHM | CHA | CHE | NYA | CHU | CHV | COR | COS | CRE | HRV | CES | DAN | DIV | NLD | DZO | ENM | EPO | EST | EWE | FAO | FIJ | FIN | FRM | FUL | GLA | GLG | LUG | KAT | ELL | GRN | GUJ | HAT | HAU | HEB | HER | HMO | HUN | ISL | IDO | IBO | IND | INA | ILE | IKU | IPK | GLE | JAV | KAL | KAN | KAU | KAS | KAZ | KIK | KIN | KIR | KOM | KON | KUA | KUR | LAO | LAT | LAV | LIM | LIN | LIT | LUB | LTZ | MKD | MLG | MSA | MAL | MLT | GLV | MRI | MAR | MAH | MON | NAU | NAV | NDE | NBL | NDO | NEP | SME | NOR | NOB | NNO | OCI | OJI | ORI | ORM | OSS | PLI | FAS | POL | PUS | QUE | QAA | RON | ROH | RUN | SMO | SAG | SAN | SRD | SRB | SNA | III | SND | SIN | SLK | SLV | SOM | SOT | SUN | SWA | SSW | SWE | TGL | TAH | TGK | TAM | TAT | TEL | THA | BOD | TIR | TON | TSO | TSN | TUR | TUK | TWI | UIG | UKR | UZB | VEN | VOL | WLN | CYM | FRY | WOL | XHO | YID | YOR | ZHA | ZUL | ORJ | QPC | TNG,
LanguageDescription: 'STRING_VALUE'
},
/* more items */
],
ContainerSettings: {
Container: F4V | ISMV | M2TS | M3U8 | CMFC | MOV | MP4 | MPD | MXF | RAW,
F4vSettings: {
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL
},
M2tsSettings: {
AudioBufferModel: DVB | ATSC,
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
Bitrate: 'NUMBER_VALUE',
BufferModel: MULTIPLEX | NONE,
DvbNitSettings: {
NetworkId: 'NUMBER_VALUE',
NetworkName: 'STRING_VALUE',
NitInterval: 'NUMBER_VALUE'
},
DvbSdtSettings: {
OutputSdt: SDT_FOLLOW | SDT_FOLLOW_IF_PRESENT | SDT_MANUAL | SDT_NONE,
SdtInterval: 'NUMBER_VALUE',
ServiceName: 'STRING_VALUE',
ServiceProviderName: 'STRING_VALUE'
},
DvbSubPids: [
'NUMBER_VALUE',
/* more items */
],
DvbTdtSettings: {
TdtInterval: 'NUMBER_VALUE'
},
DvbTeletextPid: 'NUMBER_VALUE',
EbpAudioInterval: VIDEO_AND_FIXED_INTERVALS | VIDEO_INTERVAL,
EbpPlacement: VIDEO_AND_AUDIO_PIDS | VIDEO_PID,
EsRateInPes: INCLUDE | EXCLUDE,
ForceTsVideoEbpOrder: FORCE | DEFAULT,
FragmentTime: 'NUMBER_VALUE',
MaxPcrInterval: 'NUMBER_VALUE',
MinEbpInterval: 'NUMBER_VALUE',
NielsenId3: INSERT | NONE,
NullPacketBitrate: 'NUMBER_VALUE',
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
RateMode: VBR | CBR,
Scte35Esam: {
Scte35EsamPid: 'NUMBER_VALUE'
},
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
SegmentationMarkers: NONE | RAI_SEGSTART | RAI_ADAPT | PSI_SEGSTART | EBP | EBP_LEGACY,
SegmentationStyle: MAINTAIN_CADENCE | RESET_CADENCE,
SegmentationTime: 'NUMBER_VALUE',
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
M3u8Settings: {
AudioFramesPerPes: 'NUMBER_VALUE',
AudioPids: [
'NUMBER_VALUE',
/* more items */
],
NielsenId3: INSERT | NONE,
PatInterval: 'NUMBER_VALUE',
PcrControl: PCR_EVERY_PES_PACKET | CONFIGURED_PCR_PERIOD,
PcrPid: 'NUMBER_VALUE',
PmtInterval: 'NUMBER_VALUE',
PmtPid: 'NUMBER_VALUE',
PrivateMetadataPid: 'NUMBER_VALUE',
ProgramNumber: 'NUMBER_VALUE',
Scte35Pid: 'NUMBER_VALUE',
Scte35Source: PASSTHROUGH | NONE,
TimedMetadata: PASSTHROUGH | NONE,
TimedMetadataPid: 'NUMBER_VALUE',
TransportStreamId: 'NUMBER_VALUE',
VideoPid: 'NUMBER_VALUE'
},
MovSettings: {
ClapAtom: INCLUDE | EXCLUDE,
CslgAtom: INCLUDE | EXCLUDE,
Mpeg2FourCCControl: XDCAM | MPEG,
PaddingControl: OMNEON | NONE,
Reference: SELF_CONTAINED | EXTERNAL
},
Mp4Settings: {
CslgAtom: INCLUDE | EXCLUDE,
FreeSpaceBox: INCLUDE | EXCLUDE,
MoovPlacement: PROGRESSIVE_DOWNLOAD | NORMAL,
Mp4MajorBrand: 'STRING_VALUE'
}
},
VideoDescription: {
AfdSignaling: NONE | AUTO | FIXED,
AntiAlias: DISABLED | ENABLED,
CodecSettings: {
Codec: FRAME_CAPTURE | H_264 | H_265 | MPEG2 | PRORES,
FrameCaptureSettings: {
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
MaxCaptures: 'NUMBER_VALUE',
Quality: 'NUMBER_VALUE'
},
H264Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_1_1 | LEVEL_1_2 | LEVEL_1_3 | LEVEL_2 | LEVEL_2_1 | LEVEL_2_2 | LEVEL_3 | LEVEL_3_1 | LEVEL_3_2 | LEVEL_4 | LEVEL_4_1 | LEVEL_4_2 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2,
CodecProfile: BASELINE | HIGH | HIGH_10BIT | HIGH_422 | HIGH_422_10BIT | MAIN,
DynamicSubGop: ADAPTIVE | STATIC,
EntropyEncoding: CABAC | CAVLC,
FieldEncoding: PAFF | FORCE_FIELD,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
RepeatPps: DISABLED | ENABLED,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | RP2027,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED
},
H265Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH | HIGHER | MAX,
AlternateTransferFunctionSei: DISABLED | ENABLED,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LEVEL_1 | LEVEL_2 | LEVEL_2_1 | LEVEL_3 | LEVEL_3_1 | LEVEL_4 | LEVEL_4_1 | LEVEL_5 | LEVEL_5_1 | LEVEL_5_2 | LEVEL_6 | LEVEL_6_1 | LEVEL_6_2,
CodecProfile: MAIN_MAIN | MAIN_HIGH | MAIN10_MAIN | MAIN10_HIGH | MAIN_422_8BIT_MAIN | MAIN_422_8BIT_HIGH | MAIN_422_10BIT_MAIN | MAIN_422_10BIT_HIGH,
DynamicSubGop: ADAPTIVE | STATIC,
FlickerAdaptiveQuantization: DISABLED | ENABLED,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopBReference: DISABLED | ENABLED,
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
NumberReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | SINGLE_PASS_HQ | MULTI_PASS_HQ,
QvbrSettings: {
MaxAverageBitrate: 'NUMBER_VALUE',
QvbrQualityLevel: 'NUMBER_VALUE'
},
RateControlMode: VBR | CBR | QVBR,
SampleAdaptiveOffsetFilterMode: DEFAULT | ADAPTIVE | OFF,
SceneChangeDetect: DISABLED | ENABLED,
Slices: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED,
TemporalIds: DISABLED | ENABLED,
Tiles: DISABLED | ENABLED,
UnregisteredSeiTimecode: DISABLED | ENABLED,
WriteMp4PackagingType: HVC1 | HEV1
},
Mpeg2Settings: {
AdaptiveQuantization: OFF | LOW | MEDIUM | HIGH,
Bitrate: 'NUMBER_VALUE',
CodecLevel: AUTO | LOW | MAIN | HIGH1440 | HIGH,
CodecProfile: MAIN | PROFILE_422,
DynamicSubGop: ADAPTIVE | STATIC,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
GopClosedCadence: 'NUMBER_VALUE',
GopSize: 'NUMBER_VALUE',
GopSizeUnits: FRAMES | SECONDS,
HrdBufferInitialFillPercentage: 'NUMBER_VALUE',
HrdBufferSize: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
IntraDcPrecision: AUTO | INTRA_DC_PRECISION_8 | INTRA_DC_PRECISION_9 | INTRA_DC_PRECISION_10 | INTRA_DC_PRECISION_11,
MaxBitrate: 'NUMBER_VALUE',
MinIInterval: 'NUMBER_VALUE',
NumberBFramesBetweenReferenceFrames: 'NUMBER_VALUE',
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
QualityTuningLevel: SINGLE_PASS | MULTI_PASS,
RateControlMode: VBR | CBR,
SceneChangeDetect: DISABLED | ENABLED,
SlowPal: DISABLED | ENABLED,
Softness: 'NUMBER_VALUE',
SpatialAdaptiveQuantization: DISABLED | ENABLED,
Syntax: DEFAULT | D_10,
Telecine: NONE | SOFT | HARD,
TemporalAdaptiveQuantization: DISABLED | ENABLED
},
ProresSettings: {
CodecProfile: APPLE_PRORES_422 | APPLE_PRORES_422_HQ | APPLE_PRORES_422_LT | APPLE_PRORES_422_PROXY,
FramerateControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
FramerateConversionAlgorithm: DUPLICATE_DROP | INTERPOLATE,
FramerateDenominator: 'NUMBER_VALUE',
FramerateNumerator: 'NUMBER_VALUE',
InterlaceMode: PROGRESSIVE | TOP_FIELD | BOTTOM_FIELD | FOLLOW_TOP_FIELD | FOLLOW_BOTTOM_FIELD,
ParControl: INITIALIZE_FROM_SOURCE | SPECIFIED,
ParDenominator: 'NUMBER_VALUE',
ParNumerator: 'NUMBER_VALUE',
SlowPal: DISABLED | ENABLED,
Telecine: NONE | HARD
}
},
ColorMetadata: IGNORE | INSERT,
Crop: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
DropFrameTimecode: DISABLED | ENABLED,
FixedAfd: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
Position: {
Height: 'NUMBER_VALUE',
Width: 'NUMBER_VALUE',
X: 'NUMBER_VALUE',
Y: 'NUMBER_VALUE'
},
RespondToAfd: NONE | RESPOND | PASSTHROUGH,
ScalingBehavior: DEFAULT | STRETCH_TO_OUTPUT,
Sharpness: 'NUMBER_VALUE',
TimecodeInsertion: DISABLED | PIC_TIMING_SEI,
VideoPreprocessors: {
ColorCorrector: {
Brightness: 'NUMBER_VALUE',
ColorSpaceConversion: NONE | FORCE_601 | FORCE_709 | FORCE_HDR10 | FORCE_HLG_2020,
Contrast: 'NUMBER_VALUE',
Hdr10Metadata: {
BluePrimaryX: 'NUMBER_VALUE',
BluePrimaryY: 'NUMBER_VALUE',
GreenPrimaryX: 'NUMBER_VALUE',
GreenPrimaryY: 'NUMBER_VALUE',
MaxContentLightLevel: 'NUMBER_VALUE',
MaxFrameAverageLightLevel: 'NUMBER_VALUE',
MaxLuminance: 'NUMBER_VALUE',
MinLuminance: 'NUMBER_VALUE',
RedPrimaryX: 'NUMBER_VALUE',
RedPrimaryY: 'NUMBER_VALUE',
WhitePointX: 'NUMBER_VALUE',
WhitePointY: 'NUMBER_VALUE'
},
Hue: 'NUMBER_VALUE',
Saturation: 'NUMBER_VALUE'
},
Deinterlacer: {
Algorithm: INTERPOLATE | INTERPOLATE_TICKER | BLEND | BLEND_TICKER,
Control: FORCE_ALL_FRAMES | NORMAL,
Mode: DEINTERLACE | INVERSE_TELECINE | ADAPTIVE
},
ImageInserter: {
InsertableImages: [
{
Duration: 'NUMBER_VALUE',
FadeIn: 'NUMBER_VALUE',
FadeOut: 'NUMBER_VALUE',
Height: 'NUMBER_VALUE',
ImageInserterInput: 'STRING_VALUE',
ImageX: 'NUMBER_VALUE',
ImageY: 'NUMBER_VALUE',
Layer: 'NUMBER_VALUE',
Opacity: 'NUMBER_VALUE',
StartTime: 'STRING_VALUE',
Width: 'NUMBER_VALUE'
},
/* more items */
]
},
NoiseReducer: {
Filter: BILATERAL | MEAN | GAUSSIAN | LANCZOS | SHARPEN | CONSERVE | SPATIAL,
FilterSettings: {
Strength: 'NUMBER_VALUE'
},
SpatialFilterSettings: {
PostFilterSharpenStrength: 'NUMBER_VALUE',
Speed: 'NUMBER_VALUE',
Strength: 'NUMBER_VALUE'
}
},
TimecodeBurnin: {
FontSize: 'NUMBER_VALUE',
Position: TOP_CENTER | TOP_LEFT | TOP_RIGHT | MIDDLE_LEFT | MIDDLE_CENTER | MIDDLE_RIGHT | BOTTOM_LEFT | BOTTOM_CENTER | BOTTOM_RIGHT,
Prefix: 'STRING_VALUE'
}
},
Width: 'NUMBER_VALUE'
}
}
};
mediaconvert.updatePreset(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Category
— (String
) The new category for the preset, if you are changing it.Description
— (String
) The new description for the preset, if you are changing it.Name
— (String
) The name of the preset you are modifying.Settings
— (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Preset
— (map
) A preset is a collection of preconfigured media conversion settings that you want MediaConvert to apply to the output during the conversion process.Arn
— (String
) An identifier for this resource that is unique within all of AWS.Category
— (String
) An optional category you create to organize your presets.CreatedAt
— (Date
) The timestamp in epoch seconds for preset creation.Description
— (String
) An optional description you create for each preset.LastUpdated
— (Date
) The timestamp in epoch seconds when the preset was last updated.Name
— required — (String
) A name you create for each preset. Each name must be unique within your account.Settings
— required — (map
) Settings for presetAudioDescriptions
— (Array<map>
) (AudioDescriptions) contains groups of audio encoding settings organized by audio codec. Include one instance of (AudioDescriptions) per output. (AudioDescriptions) can contain multiple groups of encoding settings.AudioNormalizationSettings
— (map
) Advanced audio normalization settings.Algorithm
— (String
) Audio normalization algorithm to use. 1770-1 conforms to the CALM Act specification, 1770-2 conforms to the EBU R-128 specification. Possible values include:"ITU_BS_1770_1"
"ITU_BS_1770_2"
AlgorithmControl
— (String
) When enabled the output audio is corrected using the chosen algorithm. If disabled, the audio will be measured but not adjusted. Possible values include:"CORRECT_AUDIO"
"MEASURE_ONLY"
CorrectionGateLevel
— (Integer
) Content measuring above this level will be corrected to the target level. Content measuring below this level will not be corrected. Gating only applies when not using real_time_correction.LoudnessLogging
— (String
) If set to LOG, log each output's audio track loudness to a CSV file. Possible values include:"LOG"
"DONT_LOG"
PeakCalculation
— (String
) If set to TRUE_PEAK, calculate and log the TruePeak for each output's audio track loudness. Possible values include:"TRUE_PEAK"
"NONE"
TargetLkfs
— (Float
) Target LKFS(loudness) to adjust volume to. If no value is entered, a default value will be used according to the chosen algorithm. The CALM Act (1770-1) recommends a target of -24 LKFS. The EBU R-128 specification (1770-2) recommends a target of -23 LKFS.
AudioSourceName
— (String
) Specifies which audio data to use from each input. In the simplest case, specify an "Audio Selector":#inputs-audio_selector by name based on its order within each input. For example if you specify "Audio Selector 3", then the third audio selector will be used from each input. If an input does not have an "Audio Selector 3", then the audio selector marked as "default" in that input will be used. If there is no audio selector marked as "default", silence will be inserted for the duration of that input. Alternatively, an "Audio Selector Group":#inputs-audio_selector_group name may be specified, with similar default/silence behavior. If no audio_source_name is specified, then "Audio Selector 1" will be chosen automatically.AudioType
— (Integer
) Applies only if Follow Input Audio Type is unchecked (false). A number between 0 and 255. The following are defined in ISO-IEC 13818-1: 0 = Undefined, 1 = Clean Effects, 2 = Hearing Impaired, 3 = Visually Impaired Commentary, 4-255 = Reserved.AudioTypeControl
— (String
) When set to FOLLOW_INPUT, if the input contains an ISO 639 audio_type, then that value is passed through to the output. If the input contains no ISO 639 audio_type, the value in Audio Type is included in the output. Otherwise the value in Audio Type is included in the output. Note that this field and audioType are both ignored if audioDescriptionBroadcasterMix is set to BROADCASTER_MIXED_AD. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
CodecSettings
— (map
) Audio codec settings (CodecSettings) under (AudioDescriptions) contains the group of settings related to audio encoding. The settings in this group vary depending on the value you choose for Audio codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * AAC, AacSettings * MP2, Mp2Settings * WAV, WavSettings * AIFF, AiffSettings * AC3, Ac3Settings * EAC3, Eac3SettingsAacSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AAC. The service accepts one of two mutually exclusive groups of AAC settings--VBR and CBR. To select one of these modes, set the value of Bitrate control mode (rateControlMode) to "VBR" or "CBR". In VBR mode, you control the audio quality with the setting VBR quality (vbrQuality). In CBR mode, you use the setting Bitrate (bitrate). Defaults and valid values depend on the rate control mode.AudioDescriptionBroadcasterMix
— (String
) Choose BROADCASTER_MIXED_AD when the input contains pre-mixed main audio + audio description (AD) as a stereo pair. The value for AudioType will be set to 3, which signals to downstream systems that this stream contains "broadcaster mixed AD". Note that the input received by the encoder must contain pre-mixed audio; the encoder does not perform the mixing. When you choose BROADCASTER_MIXED_AD, the encoder ignores any values you provide in AudioType and FollowInputAudioType. Choose NORMAL when the input does not contain pre-mixed audio + audio description (AD). In this case, the encoder will use any values you provide for AudioType and FollowInputAudioType. Possible values include:"BROADCASTER_MIXED_AD"
"NORMAL"
Bitrate
— (Integer
) Average bitrate in bits/second. The set of valid values for this setting is: 6000, 8000, 10000, 12000, 14000, 16000, 20000, 24000, 28000, 32000, 40000, 48000, 56000, 64000, 80000, 96000, 112000, 128000, 160000, 192000, 224000, 256000, 288000, 320000, 384000, 448000, 512000, 576000, 640000, 768000, 896000, 1024000. The value you set is also constrained by the values you choose for Profile (codecProfile), Bitrate control mode (codingMode), and Sample rate (sampleRate). Default values depend on Bitrate control mode and Profile.CodecProfile
— (String
) AAC Profile. Possible values include:"LC"
"HEV1"
"HEV2"
CodingMode
— (String
) Mono (Audio Description), Mono, Stereo, or 5.1 channel layout. Valid values depend on rate control mode and profile. "1.0 - Audio Description (Receiver Mix)" setting receives a stereo description plus control track and emits a mono AAC encode of the description track, with control data emitted in the PES header as per ETSI TS 101 154 Annex E. Possible values include:"AD_RECEIVER_MIX"
"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_5_1"
RateControlMode
— (String
) Rate Control Mode. Possible values include:"CBR"
"VBR"
RawFormat
— (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. Possible values include:"LATM_LOAS"
"NONE"
SampleRate
— (Integer
) Sample rate in Hz. Valid values depend on rate control mode and profile.Specification
— (String
) Use MPEG-2 AAC instead of MPEG-4 AAC audio for raw or MPEG-2 Transport Stream containers. Possible values include:"MPEG2"
"MPEG4"
VbrQuality
— (String
) VBR Quality Level - Only used if rate_control_mode is VBR. Possible values include:"LOW"
"MEDIUM_LOW"
"MEDIUM_HIGH"
"HIGH"
Ac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AC3.Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted AC-3 stream. See ATSC A/52-2012 for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"DIALOGUE"
"EMERGENCY"
"HEARING_IMPAIRED"
"MUSIC_AND_EFFECTS"
"VISUALLY_IMPAIRED"
"VOICE_OVER"
CodingMode
— (String
) Dolby Digital coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_1_1"
"CODING_MODE_2_0"
"CODING_MODE_3_2_LFE"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital, dialnorm will be passed through.DynamicRangeCompressionProfile
— (String
) If set to FILM_STANDARD, adds dynamic range compression signaling to the output bitstream as defined in the Dolby Digital specification. Possible values include:"FILM_STANDARD"
"NONE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.
AiffSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value AIFF.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
Codec
— (String
) Type of Audio codec. Possible values include:"AAC"
"MP2"
"WAV"
"AIFF"
"AC3"
"EAC3"
"PASSTHROUGH"
Eac3Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value EAC3.AttenuationControl
— (String
) If set to ATTENUATE_3_DB, applies a 3 dB attenuation to the surround channels. Only used for 3/2 coding mode. Possible values include:"ATTENUATE_3_DB"
"NONE"
Bitrate
— (Integer
) Average bitrate in bits/second. Valid bitrates depend on the coding mode.BitstreamMode
— (String
) Specifies the "Bitstream Mode" (bsmod) for the emitted E-AC-3 stream. See ATSC A/52-2012 (Annex E) for background on these values. Possible values include:"COMPLETE_MAIN"
"COMMENTARY"
"EMERGENCY"
"HEARING_IMPAIRED"
"VISUALLY_IMPAIRED"
CodingMode
— (String
) Dolby Digital Plus coding mode. Determines number of channels. Possible values include:"CODING_MODE_1_0"
"CODING_MODE_2_0"
"CODING_MODE_3_2"
DcFilter
— (String
) Activates a DC highpass filter for all input channels. Possible values include:"ENABLED"
"DISABLED"
Dialnorm
— (Integer
) Sets the dialnorm for the output. If blank and input audio is Dolby Digital Plus, dialnorm will be passed through.DynamicRangeCompressionLine
— (String
) Enables Dynamic Range Compression that restricts the absolute peak level for a signal. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
DynamicRangeCompressionRf
— (String
) Enables Heavy Dynamic Range Compression, ensures that the instantaneous signal peaks do not exceed specified levels. Possible values include:"NONE"
"FILM_STANDARD"
"FILM_LIGHT"
"MUSIC_STANDARD"
"MUSIC_LIGHT"
"SPEECH"
LfeControl
— (String
) When encoding 3/2 audio, controls whether the LFE channel is enabled Possible values include:"LFE"
"NO_LFE"
LfeFilter
— (String
) Applies a 120Hz lowpass filter to the LFE channel prior to encoding. Only valid with 3_2_LFE coding mode. Possible values include:"ENABLED"
"DISABLED"
LoRoCenterMixLevel
— (Float
) Left only/Right only center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LoRoSurroundMixLevel
— (Float
) Left only/Right only surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60LtRtCenterMixLevel
— (Float
) Left total/Right total center mix level. Only used for 3/2 coding mode. Valid values: 3.0, 1.5, 0.0, -1.5 -3.0 -4.5 -6.0 -60LtRtSurroundMixLevel
— (Float
) Left total/Right total surround mix level. Only used for 3/2 coding mode. Valid values: -1.5 -3.0 -4.5 -6.0 -60MetadataControl
— (String
) When set to FOLLOW_INPUT, encoder metadata will be sourced from the DD, DD+, or DolbyE decoder that supplied this audio data. If audio was not supplied from one of these streams, then the static metadata settings will be used. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
PassthroughControl
— (String
) When set to WHEN_POSSIBLE, input DD+ audio will be passed through if it is present on the input. this detection is dynamic over the life of the transcode. Inputs that alternate between DD+ and non-DD+ content will have a consistent DD+ output as the system alternates between passthrough and encoding. Possible values include:"WHEN_POSSIBLE"
"NO_PASSTHROUGH"
PhaseControl
— (String
) Controls the amount of phase-shift applied to the surround channels. Only used for 3/2 coding mode. Possible values include:"SHIFT_90_DEGREES"
"NO_SHIFT"
SampleRate
— (Integer
) Sample rate in hz. Sample rate is always 48000.StereoDownmix
— (String
) Stereo downmix preference. Only used for 3/2 coding mode. Possible values include:"NOT_INDICATED"
"LO_RO"
"LT_RT"
"DPL2"
SurroundExMode
— (String
) When encoding 3/2 audio, sets whether an extra center back surround channel is matrix encoded into the left and right surround channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
SurroundMode
— (String
) When encoding 2/0 audio, sets whether Dolby Surround is matrix encoded into the two channels. Possible values include:"NOT_INDICATED"
"ENABLED"
"DISABLED"
Mp2Settings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value MP2.Bitrate
— (Integer
) Average bitrate in bits/second.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. Choosing Mono in the console will give you 1 output channel; choosing Stereo will give you 2. In the API, valid values are 1 and 2.SampleRate
— (Integer
) Sample rate in hz.
WavSettings
— (map
) Required when you set (Codec) under (AudioDescriptions)>(CodecSettings) to the value WAV.BitDepth
— (Integer
) Specify Bit depth (BitDepth), in bits per sample, to choose the encoding quality for this audio track.Channels
— (Integer
) Set Channels to specify the number of channels in this output audio track. With WAV, valid values 1, 2, 4, and 8. In the console, these values are Mono, Stereo, 4-Channel, and 8-Channel, respectively.Format
— (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 of the RF64 format, set your output WAV file format to RF64. Possible values include:"RIFF"
"RF64"
SampleRate
— (Integer
) Sample rate in Hz.
CustomLanguageCode
— (String
) Specify the language for this audio output track, using the ISO 639-2 or ISO 639-3 three-letter language code. The language specified will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input.LanguageCode
— (String
) Indicates the language of the audio output track. The ISO 639 language specified in the 'Language Code' drop down will be used when 'Follow Input Language Code' is not selected or when 'Follow Input Language Code' is selected but there is no ISO 639 language code specified by the input. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageCodeControl
— (String
) Choosing FOLLOW_INPUT will cause the ISO 639 language code of the output to follow the ISO 639 language code of the input. The language specified for languageCode' will be used when USE_CONFIGURED is selected or when FOLLOW_INPUT is selected but there is no ISO 639 language code specified by the input. Possible values include:"FOLLOW_INPUT"
"USE_CONFIGURED"
RemixSettings
— (map
) Advanced audio remixing settings.ChannelMapping
— (map
) Channel mapping (ChannelMapping) contains the group of fields that hold the remixing value for each channel. Units are in dB. Acceptable values are within the range from -60 (mute) through 6. A setting of 0 passes the input channel unchanged to the output channel (no attenuation or amplification).OutputChannels
— (Array<map>
) List of output channelsInputChannels
— (Array<Integer>
) List of input channels
ChannelsIn
— (Integer
) Specify the number of audio channels from your input that you want to use in your output. With remixing, you might combine or split the data in these channels, so the number of channels in your final output might be different.ChannelsOut
— (Integer
) Specify the number of channels in this output after remixing. Valid values: 1, 2, 4, 6, 8
StreamName
— (String
) Used for MS Smooth and Apple HLS outputs. Indicates the name displayed by the player (eg. English, or Director Commentary). Alphanumeric characters, spaces, and underscore are legal.
CaptionDescriptions
— (Array<map>
) Caption settings for this preset. There can be multiple caption settings in a single output.CustomLanguageCode
— (String
) Indicates the language of the caption output track, using the ISO 639-2 or ISO 639-3 three-letter language code. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text.DestinationSettings
— (map
) Specific settings required by destination type. Note that burnin_destination_settings are not available if the source of the caption data is Embedded or Teletext.BurninDestinationSettings
— (map
) Burn-In Destination Settings.Alignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering burn-in captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
DestinationType
— (String
) Specify the format for this set of captions on this output. The default format is embedded without SCTE-20. Other options are embedded with SCTE-20, burn-in, DVB-sub, SCC, SRT, teletext, TTML, and web-VTT. If you are using SCTE-20, choose SCTE-20 plus embedded (SCTE20_PLUS_EMBEDDED) to create an output that complies with the SCTE-43 spec. To create a non-compliant output where the embedded captions come first, choose Embedded plus SCTE-20 (EMBEDDED_PLUS_SCTE20). Possible values include:"BURN_IN"
"DVB_SUB"
"EMBEDDED"
"EMBEDDED_PLUS_SCTE20"
"SCTE20_PLUS_EMBEDDED"
"SCC"
"SRT"
"SMI"
"TELETEXT"
"TTML"
"WEBVTT"
DvbSubDestinationSettings
— (map
) DVB-Sub Destination SettingsAlignment
— (String
) If no explicit x_position or y_position is provided, setting alignment to centered will place the captions at the bottom center of the output. Similarly, setting a left alignment will align captions to the bottom left of the output. If x and y positions are given in conjunction with the alignment parameter, the font will be justified (either left or centered) relative to those coordinates. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"CENTERED"
"LEFT"
BackgroundColor
— (String
) Specifies the color of the rectangle behind the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
BackgroundOpacity
— (Integer
) Specifies the opacity of the background rectangle. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.FontColor
— (String
) Specifies the color of the burned-in captions. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"WHITE"
"BLACK"
"YELLOW"
"RED"
"GREEN"
"BLUE"
FontOpacity
— (Integer
) Specifies the opacity of the burned-in captions. 255 is opaque; 0 is transparent. All burn-in and DVB-Sub font settings must match.FontResolution
— (Integer
) Font resolution in DPI (dots per inch); default is 96 dpi. All burn-in and DVB-Sub font settings must match.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 CustomLanguageCode is sufficient, use "AUTOMATIC" or leave unset. This is used to help determine the appropriate font for rendering DVB-Sub captions. Possible values include:"AUTOMATIC"
"HANS"
"HANT"
FontSize
— (Integer
) A positive integer indicates the exact font size in points. Set to 0 for automatic font size selection. All burn-in and DVB-Sub font settings must match.OutlineColor
— (String
) Specifies font outline color. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match. Possible values include:"BLACK"
"WHITE"
"YELLOW"
"RED"
"GREEN"
"BLUE"
OutlineSize
— (Integer
) Specifies font outline size in pixels. This option is not valid for source captions that are either 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.ShadowColor
— (String
) Specifies the color of the shadow cast by the captions. All burn-in and DVB-Sub font settings must match. Possible values include:"NONE"
"BLACK"
"WHITE"
ShadowOpacity
— (Integer
) Specifies the opacity of the shadow. 255 is opaque; 0 is transparent. Leaving this parameter blank is equivalent to setting it to 0 (transparent). All burn-in and DVB-Sub font settings must match.ShadowXOffset
— (Integer
) Specifies the horizontal offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels to the left. All burn-in and DVB-Sub font settings must match.ShadowYOffset
— (Integer
) Specifies the vertical offset of the shadow relative to the captions in pixels. A value of -2 would result in a shadow offset 2 pixels above the text. All burn-in and DVB-Sub font settings must match.TeletextSpacing
— (String
) Only applies to jobs with input captions in Teletext or STL formats. Specify whether the spacing between letters in your captions is set by the captions grid or varies depending on letter width. Choose fixed grid to conform to the spacing specified in the captions file more accurately. Choose proportional to make the text easier to read if the captions are closed caption. Possible values include:"FIXED_GRID"
"PROPORTIONAL"
XPosition
— (Integer
) Specifies the horizontal position of the caption relative to the left side of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the left of the output. If no explicit x_position is provided, the horizontal caption position will be determined by the alignment parameter. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.YPosition
— (Integer
) Specifies the vertical position of the caption relative to the top of the output in pixels. A value of 10 would result in the captions starting 10 pixels from the top of the output. If no explicit y_position is provided, the caption will be positioned towards the bottom of the output. This option is not valid for source captions that are STL, 608/embedded or teletext. These source settings are already pre-defined by the caption stream. All burn-in and DVB-Sub font settings must match.
EmbeddedDestinationSettings
— (map
) Settings specific to embedded/ancillary caption outputs, including 608/708 Channel destination number.Destination608ChannelNumber
— (Integer
) Ignore this setting unless your input captions are SCC format and your output container is MXF. With this combination of input captions format and output container, you can optionally use this setting to replace the input channel number with the track number that you specify. Specify a different number for each output captions track. If you don't specify an output track number, the system uses the input channel number for the output channel number. This setting applies to each output individually. You can optionally combine two captions channels in your output. The two output channel numbers can be one of the following pairs: 1,3; 2,4; 1,4; or 2,3.
SccDestinationSettings
— (map
) Settings for SCC caption output.Framerate
— (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 frame rate of the associated video. If the video frame rate is 29.97, choose 29.97 dropframe (FRAMERATE_29_97_DROPFRAME) only if the video has video_insertion=true and drop_frame_timecode=true; otherwise, choose 29.97 non-dropframe (FRAMERATE_29_97_NON_DROPFRAME). Possible values include:"FRAMERATE_23_97"
"FRAMERATE_24"
"FRAMERATE_29_97_DROPFRAME"
"FRAMERATE_29_97_NON_DROPFRAME"
TeletextDestinationSettings
— (map
) Settings for Teletext caption outputPageNumber
— (String
) Set pageNumber to the Teletext page number for the destination captions for this output. This value must be a three-digit hexadecimal string; strings ending in -FF are invalid. If you are passing through the entire set of Teletext data, do not use this field.
TtmlDestinationSettings
— (map
) Settings specific to TTML caption outputs, including Pass style information (TtmlStylePassthrough).StylePassthrough
— (String
) Pass through style and position information from a TTML-like input source (TTML, SMPTE-TT, CFF-TT) to the CFF-TT output or TTML output. Possible values include:"ENABLED"
"DISABLED"
LanguageCode
— (String
) Specify the language of this captions output track. For most captions output formats, the encoder puts this language information in the output captions metadata. If your output captions format is DVB-Sub or Burn in, the encoder uses this language information to choose the font language for rendering the captions text. Possible values include:"ENG"
"SPA"
"FRA"
"DEU"
"GER"
"ZHO"
"ARA"
"HIN"
"JPN"
"RUS"
"POR"
"ITA"
"URD"
"VIE"
"KOR"
"PAN"
"ABK"
"AAR"
"AFR"
"AKA"
"SQI"
"AMH"
"ARG"
"HYE"
"ASM"
"AVA"
"AVE"
"AYM"
"AZE"
"BAM"
"BAK"
"EUS"
"BEL"
"BEN"
"BIH"
"BIS"
"BOS"
"BRE"
"BUL"
"MYA"
"CAT"
"KHM"
"CHA"
"CHE"
"NYA"
"CHU"
"CHV"
"COR"
"COS"
"CRE"
"HRV"
"CES"
"DAN"
"DIV"
"NLD"
"DZO"
"ENM"
"EPO"
"EST"
"EWE"
"FAO"
"FIJ"
"FIN"
"FRM"
"FUL"
"GLA"
"GLG"
"LUG"
"KAT"
"ELL"
"GRN"
"GUJ"
"HAT"
"HAU"
"HEB"
"HER"
"HMO"
"HUN"
"ISL"
"IDO"
"IBO"
"IND"
"INA"
"ILE"
"IKU"
"IPK"
"GLE"
"JAV"
"KAL"
"KAN"
"KAU"
"KAS"
"KAZ"
"KIK"
"KIN"
"KIR"
"KOM"
"KON"
"KUA"
"KUR"
"LAO"
"LAT"
"LAV"
"LIM"
"LIN"
"LIT"
"LUB"
"LTZ"
"MKD"
"MLG"
"MSA"
"MAL"
"MLT"
"GLV"
"MRI"
"MAR"
"MAH"
"MON"
"NAU"
"NAV"
"NDE"
"NBL"
"NDO"
"NEP"
"SME"
"NOR"
"NOB"
"NNO"
"OCI"
"OJI"
"ORI"
"ORM"
"OSS"
"PLI"
"FAS"
"POL"
"PUS"
"QUE"
"QAA"
"RON"
"ROH"
"RUN"
"SMO"
"SAG"
"SAN"
"SRD"
"SRB"
"SNA"
"III"
"SND"
"SIN"
"SLK"
"SLV"
"SOM"
"SOT"
"SUN"
"SWA"
"SSW"
"SWE"
"TGL"
"TAH"
"TGK"
"TAM"
"TAT"
"TEL"
"THA"
"BOD"
"TIR"
"TON"
"TSO"
"TSN"
"TUR"
"TUK"
"TWI"
"UIG"
"UKR"
"UZB"
"VEN"
"VOL"
"WLN"
"CYM"
"FRY"
"WOL"
"XHO"
"YID"
"YOR"
"ZHA"
"ZUL"
"ORJ"
"QPC"
"TNG"
LanguageDescription
— (String
) Human readable information to indicate captions available for players (eg. English, or Spanish). Alphanumeric characters, spaces, and underscore are legal.
ContainerSettings
— (map
) Container specific settings.Container
— (String
) Container for this output. Some containers require a container settings object. If not specified, the default object will be created. Possible values include:"F4V"
"ISMV"
"M2TS"
"M3U8"
"CMFC"
"MOV"
"MP4"
"MPD"
"MXF"
"RAW"
F4vSettings
— (map
) Settings for F4v containerMoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
M2tsSettings
— (map
) 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 these assets, data is organized by the program map table (PMT). Each transport stream program contains subsets of data, including audio, video, and metadata. Each of these subsets of data has a numerical label called a packet identifier (PID). Each transport stream program corresponds to one MediaConvert output. The PMT lists the types of data in a program along with their PID. Downstream systems and players use the program map table to look up the PID for each type of data it accesses and then uses the PIDs to locate specific data within the asset.AudioBufferModel
— (String
) Selects between the DVB and ATSC buffer models for Dolby Digital audio. Possible values include:"DVB"
"ATSC"
AudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for any elementary audio streams you include in this output. Specify multiple PIDs as a JSON array. Default is the range 482-492.Bitrate
— (Integer
) Specify the output bitrate of the transport stream in bits per second. Setting to 0 lets the muxer automatically determine the appropriate bitrate. Other common values are 3750000, 7500000, and 15000000.BufferModel
— (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, but low-memory devices may not be able to play back the stream without interruptions. Possible values include:"MULTIPLEX"
"NONE"
DvbNitSettings
— (map
) Inserts DVB Network Information Table (NIT) at the specified table repetition interval.NetworkId
— (Integer
) The numeric value placed in the Network Information Table (NIT).NetworkName
— (String
) The network name text placed in the network_name_descriptor inside the Network Information Table. Maximum length is 256 characters.NitInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbSdtSettings
— (map
) Inserts DVB Service Description Table (NIT) at the specified table repetition interval.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 if present" copies SDT information from input stream to output stream if SDT information is present in the input, otherwise it will fall back on the user-defined values. Enter "SDT Manually" means user will enter the SDT information. "No SDT" means output stream will not contain SDT information. Possible values include:"SDT_FOLLOW"
"SDT_FOLLOW_IF_PRESENT"
"SDT_MANUAL"
"SDT_NONE"
SdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.ServiceName
— (String
) The service name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.ServiceProviderName
— (String
) The service provider name placed in the service_descriptor in the Service Description Table. Maximum length is 256 characters.
DvbSubPids
— (Array<Integer>
) Specify the packet identifiers (PIDs) for DVB subtitle data included in this output. Specify multiple PIDs as a JSON array. Default is the range 460-479.DvbTdtSettings
— (map
) Inserts DVB Time and Date Table (TDT) at the specified table repetition interval.TdtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.
DvbTeletextPid
— (Integer
) Specify the packet identifier (PID) for DVB teletext data you include in this output. Default is 499.EbpAudioInterval
— (String
) When set to VIDEO_AND_FIXED_INTERVALS, audio EBP markers will be added to partitions 3 and 4. The interval between these additional markers will be fixed, and will be slightly shorter than the video EBP marker interval. When set to VIDEO_INTERVAL, these additional markers will not be inserted. Only applicable when EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_FIXED_INTERVALS"
"VIDEO_INTERVAL"
EbpPlacement
— (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 EBP segmentation markers are is selected (segmentationMarkers is EBP or EBP_LEGACY). Possible values include:"VIDEO_AND_AUDIO_PIDS"
"VIDEO_PID"
EsRateInPes
— (String
) Controls whether to include the ES Rate field in the PES header. Possible values include:"INCLUDE"
"EXCLUDE"
ForceTsVideoEbpOrder
— (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, set this value to Force (FORCE). Possible values include:"FORCE"
"DEFAULT"
FragmentTime
— (Float
) The length, in seconds, of each fragment. Only used with EBP markers.MaxPcrInterval
— (Integer
) Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.MinEbpInterval
— (Integer
) When set, enforces that Encoder Boundary Points do not come within the specified time interval of each other by looking ahead at input video. If another EBP is going to come in within the specified time interval, the current EBP is not emitted, and the segment is "stretched" to the next marker. The lookahead value does not add latency to the system. The Live Event must be configured elsewhere to create sufficient latency to make the lookahead accurate.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
NullPacketBitrate
— (Float
) Value in bits per second of extra null packets to insert into the transport stream. This can be used if a downstream encryption system requires periodic null packets.PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET, a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Specify the packet identifier (PID) for the program clock reference (PCR) in this output. If you do not specify a value, the service will use the value for Video PID (VideoPid).PmtInterval
— (Integer
) Specify the number of milliseconds between instances of the program map table (PMT) in the output transport stream.PmtPid
— (Integer
) Specify the packet identifier (PID) for the program map table (PMT) itself. Default is 480.PrivateMetadataPid
— (Integer
) Specify the packet identifier (PID) of the private metadata stream. Default is 503.ProgramNumber
— (Integer
) Use Program number (programNumber) to specify the program number used in the program map table (PMT) for this output. Default is 1. Program numbers and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.RateMode
— (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 the output will not be padded up to that bitrate. Possible values include:"VBR"
"CBR"
Scte35Esam
— (map
) Include this in your job settings to put SCTE-35 markers in your HLS and transport stream outputs at the insertion points that you specify in an ESAM XML document. Provide the document in the setting SCC XML (sccXml).Scte35EsamPid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream generated by ESAM.
Scte35Pid
— (Integer
) Specify the packet identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
SegmentationMarkers
— (String
) Inserts segmentation markers at each segmentation_time period. rai_segstart sets the Random Access Indicator bit in the adaptation field. rai_adapt sets the RAI bit and adds the current timecode in the private data bytes. psi_segstart inserts PAT and PMT tables at the start of segments. ebp adds Encoder Boundary Point information to the adaptation field as per OpenCable specification OC-SP-EBP-I01-130118. ebp_legacy adds Encoder Boundary Point information to the adaptation field using a legacy proprietary format. Possible values include:"NONE"
"RAI_SEGSTART"
"RAI_ADAPT"
"PSI_SEGSTART"
"EBP"
"EBP_LEGACY"
SegmentationStyle
— (String
) The segmentation style parameter controls how segmentation markers are inserted into the transport stream. With avails, it is possible that segments may be truncated, which can influence where future segmentation markers are inserted. When a segmentation style of "reset_cadence" is selected and a segment is truncated due to an avail, we will reset the segmentation cadence. This means the subsequent segment will have a duration of of $segmentation_time seconds. When a segmentation style of "maintain_cadence" is selected and a segment is truncated due to an avail, we will not reset the segmentation cadence. This means the subsequent segment will likely be truncated as well. However, all segments after that will have a duration of $segmentation_time seconds. Note that EBP lookahead is a slight exception to this rule. Possible values include:"MAINTAIN_CADENCE"
"RESET_CADENCE"
SegmentationTime
— (Float
) Specify the length, in seconds, of each segment. Required unless markers is set to none.TimedMetadataPid
— (Integer
) Specify the packet identifier (PID) for timed metadata in this output. Default is 502.TransportStreamId
— (Integer
) Specify the ID for the transport stream itself in the program map table for this output. Transport stream IDs and program map tables are parts of MPEG-2 transport stream containers, used for organizing data.VideoPid
— (Integer
) Specify the packet identifier (PID) of the elementary video stream in the transport stream.
M3u8Settings
— (map
) Settings for TS segments in HLSAudioFramesPerPes
— (Integer
) The number of audio frames to insert for each PES packet.AudioPids
— (Array<Integer>
) Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.NielsenId3
— (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. Possible values include:"INSERT"
"NONE"
PatInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PcrControl
— (String
) When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream. Possible values include:"PCR_EVERY_PES_PACKET"
"CONFIGURED_PCR_PERIOD"
PcrPid
— (Integer
) Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.PmtInterval
— (Integer
) The number of milliseconds between instances of this table in the output transport stream.PmtPid
— (Integer
) Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.PrivateMetadataPid
— (Integer
) Packet Identifier (PID) of the private metadata stream in the transport stream.ProgramNumber
— (Integer
) The value of the program number field in the Program Map Table.Scte35Pid
— (Integer
) Packet Identifier (PID) of the SCTE-35 stream in the transport stream.Scte35Source
— (String
) Enables SCTE-35 passthrough (scte35Source) to pass any SCTE-35 signals from input to output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadata
— (String
) Applies only to HLS outputs. Use this setting to specify whether the service inserts the ID3 timed metadata from the input in this output. Possible values include:"PASSTHROUGH"
"NONE"
TimedMetadataPid
— (Integer
) Packet Identifier (PID) of the timed metadata stream in the transport stream.TransportStreamId
— (Integer
) The value of the transport stream ID field in the Program Map Table.VideoPid
— (Integer
) Packet Identifier (PID) of the elementary video stream in the transport stream.
MovSettings
— (map
) Settings for MOV Container.ClapAtom
— (String
) When enabled, include 'clap' atom if appropriate for the video output settings. Possible values include:"INCLUDE"
"EXCLUDE"
CslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
Mpeg2FourCCControl
— (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, but may decrease compatibility with other players. Only applicable when the video codec is MPEG2. Possible values include:"XDCAM"
"MPEG"
PaddingControl
— (String
) If set to OMNEON, inserts Omneon-compatible padding Possible values include:"OMNEON"
"NONE"
Reference
— (String
) Always keep the default value (SELF_CONTAINED) for this setting. Possible values include:"SELF_CONTAINED"
"EXTERNAL"
Mp4Settings
— (map
) Settings for MP4 ContainerCslgAtom
— (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 'cslg' (composition shift least greatest) box will be included per 14496-1 amendment 1. This improves compatibility with Apple players and tools. Possible values include:"INCLUDE"
"EXCLUDE"
FreeSpaceBox
— (String
) Inserts a free-space box immediately after the moov box. Possible values include:"INCLUDE"
"EXCLUDE"
MoovPlacement
— (String
) If set to PROGRESSIVE_DOWNLOAD, the MOOV atom is relocated to the beginning of the archive as required for progressive downloading. Otherwise it is placed normally at the end. Possible values include:"PROGRESSIVE_DOWNLOAD"
"NORMAL"
Mp4MajorBrand
— (String
) Overrides the "Major Brand" field in the output file. Usually not necessary to specify.
VideoDescription
— (map
) (VideoDescription) contains a group of video encoding settings. The specific video settings depend on the video codec you choose when you specify a value for Video codec (codec). Include one instance of (VideoDescription) per output.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 output video data and what those values are. * Choose None to remove all AFD values from this output. * Choose Fixed to ignore input AFD values and instead encode the value specified in the job. * Choose Auto to calculate output AFD values based on the input AFD scaler data. Possible values include:"NONE"
"AUTO"
"FIXED"
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, the service will ignore the setting. Possible values include:"DISABLED"
"ENABLED"
CodecSettings
— (map
) Video codec settings, (CodecSettings) under (VideoDescription), contains the group of settings related to video encoding. The settings in this group vary depending on the value you choose for Video codec (Codec). For each codec enum you choose, define the corresponding settings object. The following lists the codec enum, settings object pairs. * H_264, H264Settings * H_265, H265Settings * MPEG2, Mpeg2Settings * PRORES, ProresSettings * FRAME_CAPTURE, FrameCaptureSettingsCodec
— (String
) Specifies the video codec. This must be equal to one of the enum values defined by the object VideoCodec. Possible values include:"FRAME_CAPTURE"
"H_264"
"H_265"
"MPEG2"
"PRORES"
FrameCaptureSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value FRAME_CAPTURE.FramerateDenominator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.n.jpg where n is the 0-based sequence number of each Capture.FramerateNumerator
— (Integer
) Frame capture will encode the first frame of the output stream, then one frame every framerateDenominator/framerateNumerator seconds. For example, settings of framerateNumerator = 1 and framerateDenominator = 3 (a rate of 1/3 frame per second) will capture the first frame, then 1 frame every 3s. Files will be named as filename.NNNNNNN.jpg where N is the 0-based frame sequence number zero padded to 7 decimal places.MaxCaptures
— (Integer
) Maximum number of captures (encoded jpg output files).Quality
— (Integer
) JPEG Quality - a higher value equals higher quality.
H264Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value H_264.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (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). Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_1_1"
"LEVEL_1_2"
"LEVEL_1_3"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_2_2"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_3_2"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_4_2"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
CodecProfile
— (String
) H.264 Profile. High 4:2:2 and 10-bit profiles are only available with the AVC-I License. Possible values include:"BASELINE"
"HIGH"
"HIGH_10BIT"
"HIGH_422"
"HIGH_422_10BIT"
"MAIN"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
EntropyEncoding
— (String
) Entropy encoding mode. Use CABAC (must be in Main or High profile) or CAVLC. Possible values include:"CABAC"
"CAVLC"
FieldEncoding
— (String
) Choosing FORCE_FIELD disables PAFF encoding for interlaced outputs. Possible values include:"PAFF"
"FORCE_FIELD"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job specification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateDenominator to specify the denominator of this fraction. In this example, use 1001 for the value of FramerateDenominator. When you use the console for transcode jobs that use frame rate conversion, provide the value as a decimal number for Framerate. In this example, specify 23.976.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H264 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type, as follows. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H264QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.264 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h264Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
RepeatPps
— (String
) Places a PPS header on each encoded picture, even if repeated. Possible values include:"DISABLED"
"ENABLED"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a bitstream compliant with SMPTE RP-2027. Possible values include:"DEFAULT"
"RP2027"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
H265Settings
— (map
) Settings for H265 codecAdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
"HIGHER"
"MAX"
AlternateTransferFunctionSei
— (String
) Enables Alternate Transfer Function SEI message for outputs using Hybrid Log Gamma (HLG) Electro-Optical Transfer Function (EOTF). Possible values include:"DISABLED"
"ENABLED"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) H.265 Level. Possible values include:"AUTO"
"LEVEL_1"
"LEVEL_2"
"LEVEL_2_1"
"LEVEL_3"
"LEVEL_3_1"
"LEVEL_4"
"LEVEL_4_1"
"LEVEL_5"
"LEVEL_5_1"
"LEVEL_5_2"
"LEVEL_6"
"LEVEL_6_1"
"LEVEL_6_2"
CodecProfile
— (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 High Tier. 4:2:2 profiles are only available with the HEVC 4:2:2 License. Possible values include:"MAIN_MAIN"
"MAIN_HIGH"
"MAIN10_MAIN"
"MAIN10_HIGH"
"MAIN_422_8BIT_MAIN"
"MAIN_422_8BIT_HIGH"
"MAIN_422_10BIT_MAIN"
"MAIN_422_10BIT_HIGH"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FlickerAdaptiveQuantization
— (String
) Adjust quantization within each frame to reduce flicker or 'pop' on I-frames. Possible values include:"DISABLED"
"ENABLED"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopBReference
— (String
) If enable, use reference B frames for GOP structures that have B frames > 1. Possible values include:"DISABLED"
"ENABLED"
GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in H265 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000. Required when Rate control mode is QVBR.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.NumberReferenceFrames
— (Integer
) Number of reference frames to use. The encoder may use more than requested if using B-frames and/or interlaced encoding.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (H265QualityTuningLevel) to specifiy whether to use fast single-pass, high-quality singlepass, or high-quality multipass video encoding. Possible values include:"SINGLE_PASS"
"SINGLE_PASS_HQ"
"MULTI_PASS_HQ"
QvbrSettings
— (map
) Settings for quality-defined variable bitrate encoding with the H.265 codec. Required when you set Rate control mode to QVBR. Not valid when you set Rate control mode to a value other than QVBR, or when you don't define Rate control mode.MaxAverageBitrate
— (Integer
) Use this setting only when Rate control mode is QVBR and Quality tuning level is Multi-pass HQ. For Max average bitrate values suited to the complexity of your input video, the service limits the average bitrate of the video part of this output to the value you choose. That is, the total size of the video element is less than or equal to the value you set multiplied by the number of seconds of encoded output.QvbrQualityLevel
— (Integer
) Required when you use QVBR rate control mode. That is, when you specify qvbrSettings within h265Settings. Specify the target quality level for this output, from 1 to 10. Use higher numbers for greater quality. Level 10 results in nearly lossless compression. The quality level for most broadcast-quality transcodes is between 6 and 9.
RateControlMode
— (String
) Use this setting to specify whether this output has a variable bitrate (VBR), constant bitrate (CBR) or quality-defined variable bitrate (QVBR). Possible values include:"VBR"
"CBR"
"QVBR"
SampleAdaptiveOffsetFilterMode
— (String
) Specify Sample Adaptive Offset (SAO) filter strength. Adaptive mode dynamically selects best strength based on content Possible values include:"DEFAULT"
"ADAPTIVE"
"OFF"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
Slices
— (Integer
) Number of slices per picture. Must be less than or equal to the number of macroblock rows for progressive pictures, and less than or equal to half the number of macroblock rows for interlaced pictures.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (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 > Deinterlacer field (deinterlace_mode) and the Streams > Advanced > Interlaced Mode field (interlace_mode) to identify the scan type for the output: Progressive, Interlaced, Hard Telecine or Soft Telecine. - Hard: produces 29.97i output from 23.976 input. - Soft: produces 23.976; the player converts this output to 29.97i. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
TemporalIds
— (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 B-frames can form a second layer and non-reference b-frames can form a third layer. Decoders can optionally decode only the lower temporal layers to generate a lower frame rate output. For example, given a bitstream with temporal IDs and with b-frames = 1 (i.e. IbPbPb display order), a decoder could decode all the frames for full frame rate output or only the I and P frames (lowest temporal layer) for a half frame rate output. Possible values include:"DISABLED"
"ENABLED"
Tiles
— (String
) Enable use of tiles, allowing horizontal as well as vertical subdivision of the encoded pictures. Possible values include:"DISABLED"
"ENABLED"
UnregisteredSeiTimecode
— (String
) Inserts timecode for each frame as 4 bytes of an unregistered SEI message. Possible values include:"DISABLED"
"ENABLED"
WriteMp4PackagingType
— (String
) Use this setting only for outputs encoded with H.265 that are in CMAF or DASH output groups. If you include writeMp4PackagingType in your JSON job specification for other outputs, your video might not work properly with downstream systems and video players. If the location of parameter set NAL units don't matter in your workflow, ignore this setting. The service defaults to marking your output as HEV1. Choose HVC1 to mark your output as HVC1. This makes your output compliant with this specification: ISO IECJTC1 SC29 N13798 Text ISO/IEC FDIS 14496-15 3rd Edition. For these outputs, the service stores parameter set NAL units in the sample headers but not in the samples directly. Keep the default HEV1 to mark your output as HEV1. For these outputs, the service writes parameter set NAL units directly into the samples. Possible values include:"HVC1"
"HEV1"
Mpeg2Settings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value MPEG2.AdaptiveQuantization
— (String
) Adaptive quantization. Allows intra-frame quantizers to vary to improve visual quality. Possible values include:"OFF"
"LOW"
"MEDIUM"
"HIGH"
Bitrate
— (Integer
) Average bitrate in bits/second. Required for VBR and CBR. For MS Smooth outputs, bitrates must be unique when rounded down to the nearest multiple of 1000.CodecLevel
— (String
) Use Level (Mpeg2CodecLevel) to set the MPEG-2 level for the video output. Possible values include:"AUTO"
"LOW"
"MAIN"
"HIGH1440"
"HIGH"
CodecProfile
— (String
) Use Profile (Mpeg2CodecProfile) to set the MPEG-2 profile for the video output. Possible values include:"MAIN"
"PROFILE_422"
DynamicSubGop
— (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 on other frames) for high-motion portions of the video and more B-frames for low-motion portions. The maximum number of B-frames is limited by the value you provide for the setting B frames between reference frames (numberBFramesBetweenReferenceFrames). Possible values include:"ADAPTIVE"
"STATIC"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) Frame rate numerator - frame rate is a fraction, e.g. 24000 / 1001 = 23.976 fps.GopClosedCadence
— (Integer
) Frequency of closed GOPs. In streaming applications, it is recommended that this be set to 1 so a decoder joining mid-stream will receive an IDR frame as quickly as possible. Setting this value to 0 will break output segmenting.GopSize
— (Float
) GOP Length (keyframe interval) in frames or seconds. Must be greater than zero.GopSizeUnits
— (String
) Indicates if the GOP Size in MPEG2 is specified in frames or seconds. If seconds the system will convert the GOP Size into a frame count at run time. Possible values include:"FRAMES"
"SECONDS"
HrdBufferInitialFillPercentage
— (Integer
) Percentage of the buffer that should initially be filled (HRD buffer model).HrdBufferSize
— (Integer
) Size of buffer (HRD buffer model) in bits. For example, enter five megabits as 5000000.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
IntraDcPrecision
— (String
) Use Intra DC precision (Mpeg2IntraDcPrecision) to set quantization precision for intra-block DC coefficients. If you choose the value auto, the service will automatically select the precision based on the per-frame compression ratio. Possible values include:"AUTO"
"INTRA_DC_PRECISION_8"
"INTRA_DC_PRECISION_9"
"INTRA_DC_PRECISION_10"
"INTRA_DC_PRECISION_11"
MaxBitrate
— (Integer
) Maximum bitrate in bits/second. For example, enter five megabits per second as 5000000.MinIInterval
— (Integer
) Enforces separation between repeated (cadence) I-frames and I-frames inserted by Scene Change Detection. If a scene change I-frame is within I-interval frames of a cadence I-frame, the GOP is shrunk and/or stretched to the scene change I-frame. GOP stretch requires enabling lookahead as well as setting I-interval. The normal cadence resumes for the next GOP. This setting is only used when Scene Change Detect is enabled. Note: Maximum GOP stretch = GOP size + Min-I-interval - 1NumberBFramesBetweenReferenceFrames
— (Integer
) Number of B-frames between reference frames.ParControl
— (String
) Using the API, enable ParFollowSource if you want the service to use the pixel aspect ratio from the input. Using the console, do this by choosing Follow source for Pixel aspect ratio. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.QualityTuningLevel
— (String
) Use Quality tuning level (Mpeg2QualityTuningLevel) to specifiy whether to use single-pass or multipass video encoding. Possible values include:"SINGLE_PASS"
"MULTI_PASS"
RateControlMode
— (String
) Use Rate control mode (Mpeg2RateControlMode) to specifiy whether the bitrate is variable (vbr) or constant (cbr). Possible values include:"VBR"
"CBR"
SceneChangeDetect
— (String
) Scene change detection (inserts I-frames on scene changes). Possible values include:"DISABLED"
"ENABLED"
SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Softness
— (Integer
) Softness. Selects quantizer matrix, larger values reduce high-frequency content in the encoded image.SpatialAdaptiveQuantization
— (String
) Adjust quantization within each frame based on spatial variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
Syntax
— (String
) Produces a Type D-10 compatible bitstream (SMPTE 356M-2001). Possible values include:"DEFAULT"
"D_10"
Telecine
— (String
) Only use Telecine (Mpeg2Telecine) when you set Framerate (Framerate) to 29.970. Set Telecine (Mpeg2Telecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"SOFT"
"HARD"
TemporalAdaptiveQuantization
— (String
) Adjust quantization within each frame based on temporal variation of content complexity. Possible values include:"DISABLED"
"ENABLED"
ProresSettings
— (map
) Required when you set (Codec) under (VideoDescription)>(CodecSettings) to the value PRORES.CodecProfile
— (String
) Use Profile (ProResCodecProfile) to specifiy the type of Apple ProRes codec to use for this output. Possible values include:"APPLE_PRORES_422"
"APPLE_PRORES_422_HQ"
"APPLE_PRORES_422_LT"
"APPLE_PRORES_422_PROXY"
FramerateControl
— (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, choose Follow source. If you want to do frame rate conversion, choose a frame rate from the dropdown list or choose Custom. The framerates shown in the dropdown list are decimal approximations of fractions. If you choose Custom, specify your frame rate as a fraction. If you are creating your transcoding job sepecification as a JSON file without the console, use FramerateControl to specify which value the service uses for the frame rate for this output. Choose INITIALIZE_FROM_SOURCE if you want the service to use the frame rate from the input. Choose SPECIFIED if you want the service to use the frame rate you specify in the settings FramerateNumerator and FramerateDenominator. Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
FramerateConversionAlgorithm
— (String
) When set to INTERPOLATE, produces smoother motion during frame rate conversion. Possible values include:"DUPLICATE_DROP"
"INTERPOLATE"
FramerateDenominator
— (Integer
) Frame rate denominator.FramerateNumerator
— (Integer
) When you use the API for transcode jobs that use frame rate conversion, specify the frame rate as a fraction. For example, 24000 / 1001 = 23.976 fps. Use FramerateNumerator to specify the numerator of this fraction. In this example, use 24000 for the value of FramerateNumerator.InterlaceMode
— (String
) Use Interlace mode (InterlaceMode) to choose the scan line type for the output. * Top Field First (TOP_FIELD) and Bottom Field First (BOTTOM_FIELD) produce interlaced output with the entire output having the same field polarity (top or bottom first). * Follow, Default Top (FOLLOW_TOP_FIELD) and Follow, Default Bottom (FOLLOW_BOTTOM_FIELD) use the same field polarity as the source. Therefore, behavior depends on the input scan type. - If the source is interlaced, the output will be interlaced with the same polarity as the source (it will follow the source). The output could therefore be a mix of "top field first" and "bottom field first". - If the source is progressive, the output will be interlaced with "top field first" or "bottom field first" polarity, depending on which of the Follow options you chose. Possible values include:"PROGRESSIVE"
"TOP_FIELD"
"BOTTOM_FIELD"
"FOLLOW_TOP_FIELD"
"FOLLOW_BOTTOM_FIELD"
ParControl
— (String
) Use (ProresParControl) to specify how the service determines the pixel aspect ratio. Set to Follow source (INITIALIZE_FROM_SOURCE) to use the pixel aspect ratio from the input. To specify a different pixel aspect ratio: Using the console, choose it from the dropdown menu. Using the API, set ProresParControl to (SPECIFIED) and provide for (ParNumerator) and (ParDenominator). Possible values include:"INITIALIZE_FROM_SOURCE"
"SPECIFIED"
ParDenominator
— (Integer
) Pixel Aspect Ratio denominator.ParNumerator
— (Integer
) Pixel Aspect Ratio numerator.SlowPal
— (String
) Enables Slow PAL rate conversion. 23.976fps and 24fps input is relabeled as 25fps, and audio is sped up correspondingly. Possible values include:"DISABLED"
"ENABLED"
Telecine
— (String
) Only use Telecine (ProresTelecine) when you set Framerate (Framerate) to 29.970. Set Telecine (ProresTelecine) to Hard (hard) to produce a 29.97i output from a 23.976 input. Set it to Soft (soft) to produce 23.976 output and leave converstion to the player. Possible values include:"NONE"
"HARD"
ColorMetadata
— (String
) Enable Insert color metadata (ColorMetadata) to include color metadata in this output. This setting is enabled by default. Possible values include:"IGNORE"
"INSERT"
Crop
— (map
) Applies only if your input aspect ratio is different from your output aspect ratio. Use Input cropping rectangle (Crop) to specify the video area the service will include in the output. This will crop the input source, causing video pixels to be removed on encode. If you crop your input frame size to smaller than your output frame size, make sure to specify the behavior you want in your output setting "Scaling behavior".Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 timecode, the system will fall back to non-drop-frame. This setting is enabled by default when Timecode insertion (TimecodeInsertion) is enabled. Possible values include:"DISABLED"
"ENABLED"
FixedAfd
— (Integer
) Applies only if you set AFD Signaling(AfdSignaling) to Fixed (FIXED). Use Fixed (FixedAfd) to specify a four-bit AFD value which the service will write on all frames of this video output.Height
— (Integer
) Use the Height (Height) setting to define the video resolution height for this output. Specify in pixels. If you don't provide a value here, the service will use the input height.Position
— (map
) Use Position (Position) to point to a rectangle object to define your position. This setting overrides any other aspect ratio.Height
— (Integer
) Height of rectangle in pixels. Specify only even numbers.Width
— (Integer
) Width of rectangle in pixels. Specify only even numbers.X
— (Integer
) The distance, in pixels, between the rectangle and the left edge of the video frame. Specify only even numbers.Y
— (Integer
) The distance, in pixels, between the rectangle and the top edge of the video frame. Specify only even numbers.
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 video frame according to the AFD value, input display aspect ratio, and output display aspect ratio. * Choose Passthrough to include the input AFD values. Do not choose this when AfdSignaling is set to (NONE). A preferred implementation of this workflow is to set RespondToAfd to (NONE) and set AfdSignaling to (AUTO). * Choose None to remove all input AFD values from this output. Possible values include:"NONE"
"RESPOND"
"PASSTHROUGH"
ScalingBehavior
— (String
) Applies only if your input aspect ratio is different from your output aspect ratio. Choose "Stretch to output" to have the service stretch your video image to fit. Keep the setting "Default" to allow the service to letterbox your video instead. This setting overrides any positioning value you specify elsewhere in the job. Possible values include:"DEFAULT"
"STRETCH_TO_OUTPUT"
Sharpness
— (Integer
) Use Sharpness (Sharpness) setting to specify the strength of anti-aliasing. This setting changes the width of the anti-alias filter kernel used for scaling. Sharpness only applies if your output resolution is different from your input resolution. 0 is the softest setting, 100 the sharpest, and 50 recommended for most content.TimecodeInsertion
— (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 include timecodes in this output, set Timecode insertion (VideoTimecodeInsertion) to PIC_TIMING_SEI. To leave them out, set it to DISABLED. Default is DISABLED. When the service inserts timecodes in an output, by default, it uses any embedded timecodes from the input. If none are present, the service will set the timecode for the first output frame to zero. To change this default behavior, adjust the settings under Timecode configuration (TimecodeConfig). In the console, these settings are located under Job > Job settings > Timecode configuration. Note - Timecode source under input settings (InputTimecodeSource) does not affect the timecodes that are inserted in the output. Source under Job settings > Timecode configuration (TimecodeSource) does. Possible values include:"DISABLED"
"PIC_TIMING_SEI"
VideoPreprocessors
— (map
) Find additional transcoding features under Preprocessors (VideoPreprocessors). Enable the features at each output individually. These features are disabled by default.ColorCorrector
— (map
) Enable the Color corrector (ColorCorrector) feature if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Brightness
— (Integer
) Brightness level.ColorSpaceConversion
— (String
) Determines if colorspace conversion will be performed. If set to None, no conversion will be performed. If Force 601 or Force 709 are selected, conversion will be performed for inputs with differing colorspaces. An input's colorspace can be specified explicitly in the "Video Selector":#inputs-video_selector if necessary. Possible values include:"NONE"
"FORCE_601"
"FORCE_709"
"FORCE_HDR10"
"FORCE_HLG_2020"
Contrast
— (Integer
) Contrast level.Hdr10Metadata
— (map
) Use the HDR master display (Hdr10Metadata) settings to correct HDR metadata or to provide missing metadata. Note that these settings are not color correction.BluePrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.BluePrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.GreenPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.MaxContentLightLevel
— (Integer
) Maximum light level among all samples in the coded video sequence, in units of candelas per square meter.MaxFrameAverageLightLevel
— (Integer
) Maximum average light level of any frame in the coded video sequence, in units of candelas per square meter.MaxLuminance
— (Integer
) Nominal maximum mastering display luminance in units of of 0.0001 candelas per square meter.MinLuminance
— (Integer
) Nominal minimum mastering display luminance in units of of 0.0001 candelas per square meterRedPrimaryX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.RedPrimaryY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointX
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.WhitePointY
— (Integer
) HDR Master Display Information must be provided by a color grader, using color grading tools. Range is 0 to 50,000, each increment represents 0.00002 in CIE1931 color coordinate. Note that this setting is not for color correction.
Hue
— (Integer
) Hue in degrees.Saturation
— (Integer
) Saturation level.
Deinterlacer
— (map
) Use Deinterlacer (Deinterlacer) to produce smoother motion and a clearer picture.Algorithm
— (String
) Only applies when you set Deinterlacer (DeinterlaceMode) to Deinterlace (DEINTERLACE) or Adaptive (ADAPTIVE). Motion adaptive interpolate (INTERPOLATE) produces sharper pictures, while blend (BLEND) produces smoother motion. Use (INTERPOLATE_TICKER) OR (BLEND_TICKER) if your source file includes a ticker, such as a scrolling headline at the bottom of the frame. Possible values include:"INTERPOLATE"
"INTERPOLATE_TICKER"
"BLEND"
"BLEND_TICKER"
Control
— (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 as some other type. - When set to FORCE_ALL_FRAMES, the deinterlacer converts every frame to progressive - even those that are already tagged as progressive. Turn Force mode on only if there is a good chance that the metadata has tagged frames as progressive when they are not progressive. Do not turn on otherwise; processing frames that are already progressive into progressive will probably result in lower quality video. Possible values include:"FORCE_ALL_FRAMES"
"NORMAL"
Mode
— (String
) Use Deinterlacer (DeinterlaceMode) to choose how the service will do deinterlacing. Default is Deinterlace. - Deinterlace converts interlaced to progressive. - Inverse telecine converts Hard Telecine 29.97i to progressive 23.976p. - Adaptive auto-detects and converts to progressive. Possible values include:"DEINTERLACE"
"INVERSE_TELECINE"
"ADAPTIVE"
ImageInserter
— (map
) Enable the Image inserter (ImageInserter) feature to include a graphic overlay on your video. Enable or disable this feature for each output individually. This setting is disabled by default.InsertableImages
— (Array<map>
) Specify the images that you want to overlay on your video. The images must be PNG or TGA files.Duration
— (Integer
) Specify the time, in milliseconds, for the image to remain on the output video. This duration includes fade-in time but not fade-out time.FadeIn
— (Integer
) Specify the length of time, in milliseconds, between the Start time that you specify for the image insertion and the time that the image appears at full opacity. Full opacity is the level that you specify for the opacity setting. If you don't specify a value for Fade-in, the image will appear abruptly at the overlay start time.FadeOut
— (Integer
) Specify the length of time, in milliseconds, between the end of the time that you have specified for the image overlay Duration and when the overlaid image has faded to total transparency. If you don't specify a value for Fade-out, the image will disappear abruptly at the end of the inserted image duration.Height
— (Integer
) Specify the height of the inserted image in pixels. If you specify a value that's larger than the video resolution height, the service will crop your overlaid image to fit. To use the native height of the image, keep this setting blank.ImageInserterInput
— (String
) Specify the Amazon S3 location of the image that you want to overlay on the video. Use a PNG or TGA file.ImageX
— (Integer
) Specify the distance, in pixels, between the inserted image and the left edge of the video frame. Required for any image overlay that you specify.ImageY
— (Integer
) Specify the distance, in pixels, between the overlaid image and the top edge of the video frame. Required for any image overlay that you specify.Layer
— (Integer
) Specify how overlapping inserted images appear. Images with higher values for Layer appear on top of images with lower values for Layer.Opacity
— (Integer
) Use Opacity (Opacity) to specify how much of the underlying video shows through the inserted image. 0 is transparent and 100 is fully opaque. Default is 50.StartTime
— (String
) Specify the timecode of the frame that you want the overlay to first appear on. This must be in timecode (HH:MM:SS:FF or HH:MM:SS;FF) format. Remember to take into account your timecode source settings.Width
— (Integer
) Specify the width of the inserted image in pixels. If you specify a value that's larger than the video resolution width, the service will crop your overlaid image to fit. To use the native width of the image, keep this setting blank.
NoiseReducer
— (map
) Enable the Noise reducer (NoiseReducer) feature to remove noise from your video output if necessary. Enable or disable this feature for each output individually. This setting is disabled by default.Filter
— (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 reducer (NoiseReducer). * Bilateral is an edge preserving noise reduction filter. * Mean (softest), Gaussian, Lanczos, and Sharpen (sharpest) are convolution filters. * Conserve is a min/max noise reduction filter. * Spatial is a frequency-domain filter based on JND principles. Possible values include:"BILATERAL"
"MEAN"
"GAUSSIAN"
"LANCZOS"
"SHARPEN"
"CONSERVE"
"SPATIAL"
FilterSettings
— (map
) Settings for a noise reducer filterStrength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
SpatialFilterSettings
— (map
) Noise reducer filter settings for spatial filter.PostFilterSharpenStrength
— (Integer
) Specify strength of post noise reduction sharpening filter, with 0 disabling the filter and 3 enabling it at maximum strength.Speed
— (Integer
) The speed of the filter, from -2 (lower speed) to 3 (higher speed), with 0 being the nominal value.Strength
— (Integer
) Relative strength of noise reducing filter. Higher values produce stronger filtering.
TimecodeBurnin
— (map
) Timecode burn-in (TimecodeBurnIn)--Burns the output timecode and specified prefix into the output.FontSize
— (Integer
) Use Font Size (FontSize) to set the font size of any burned-in timecode. Valid values are 10, 16, 32, 48.Position
— (String
) Use Position (Position) under under Timecode burn-in (TimecodeBurnIn) to specify the location the burned-in timecode on output video. Possible values include:"TOP_CENTER"
"TOP_LEFT"
"TOP_RIGHT"
"MIDDLE_LEFT"
"MIDDLE_CENTER"
"MIDDLE_RIGHT"
"BOTTOM_LEFT"
"BOTTOM_CENTER"
"BOTTOM_RIGHT"
Prefix
— (String
) Use Prefix (Prefix) to place ASCII characters before any burned-in timecode. For example, a prefix of "EZ-" will result in the timecode "EZ-00:00:00:00". Provide either the characters themselves or the ASCII code equivalents. The supported range of characters is 0x20 through 0x7e. This includes letters, numbers, and all special characters represented on a standard English keyboard.
Width
— (Integer
) Use Width (Width) to define the video resolution width, in pixels, for this output. If you don't provide a value here, the service will use the input width.
Type
— (String
) A preset can be of two types: system or custom. System or built-in preset can't be modified or deleted by the user. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns:
updateQueue(params = {}, callback) ⇒ AWS.Request
Modify one of your existing queues.
Service Reference:
Examples:
Calling the updateQueue operation
var params = {
Name: 'STRING_VALUE', /* required */
Description: 'STRING_VALUE',
ReservationPlanSettings: {
Commitment: ONE_YEAR, /* required */
RenewalType: AUTO_RENEW | EXPIRE, /* required */
ReservedSlots: 'NUMBER_VALUE' /* required */
},
Status: ACTIVE | PAUSED
};
mediaconvert.updateQueue(params, function(err, data) {
if (err) console.log(err, err.stack); // an error occurred
else console.log(data); // successful response
});
Parameters:
-
params
(Object)
(defaults to: {})
—
Description
— (String
) The new description for the queue, if you are changing it.Name
— (String
) The name of the queue that you are modifying.ReservationPlanSettings
— (map
) The new details of your pricing plan for your reserved queue. When you set up a new pricing plan to replace an expired one, you enter into another 12-month commitment. When you add capacity to your queue by increasing the number of RTS, you extend the term of your commitment to 12 months from when you add capacity. After you make these commitments, you can't cancel them.Commitment
— required — (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
RenewalType
— required — (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. When your term is auto renewed, you extend your commitment by 12 months from the auto renew date. You can cancel this commitment. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— required — (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. You can't decrease the number of RTS in your reserved queue. You can increase the number of RTS by extending your existing commitment with a new 12-month commitment for the larger number. The new commitment begins when you purchase the additional capacity. You can't cancel your commitment or revert to your original commitment after you increase the capacity.
Status
— (String
) Pause or activate a queue by changing its status between ACTIVE and PAUSED. If you pause a queue, jobs in that queue won't begin. Jobs that are running when you pause the queue continue to run until they finish or result in an error. Possible values include:"ACTIVE"
"PAUSED"
Callback (callback):
-
function(err, data) { ... }
Called when a response from the service is returned. If a callback is not supplied, you must call AWS.Request.send() on the returned request object to initiate the request.
Context (this):
-
(AWS.Response)
—
the response object containing error, data properties, and the original request object.
Parameters:
-
err
(Error)
—
the error object returned from the request. Set to
null
if the request is successful. -
data
(Object)
—
the de-serialized data returned from the request. Set to
null
if a request error occurs. Thedata
object has the following properties:Queue
— (map
) You can use queues to manage the resources that are available to your AWS account for running multiple transcoding jobs at the same time. If you don't specify a queue, the service sends all jobs through the default queue. For more information, see https://docs.aws.amazon.com/mediaconvert/latest/ug/working-with-queues.html.Arn
— (String
) An identifier for this resource that is unique within all of AWS.CreatedAt
— (Date
) The timestamp in epoch seconds for when you created the queue.Description
— (String
) An optional description that you create for each queue.LastUpdated
— (Date
) The timestamp in epoch seconds for when you most recently updated the queue.Name
— required — (String
) A name that you create for each queue. Each name must be unique within your account.PricingPlan
— (String
) Specifies whether the pricing plan for the queue is on-demand or reserved. For on-demand, you pay per minute, billed in increments of .01 minute. For reserved, you pay for the transcoding capacity of the entire queue, regardless of how much or how little you use it. Reserved pricing requires a 12-month commitment. Possible values include:"ON_DEMAND"
"RESERVED"
ProgressingJobsCount
— (Integer
) The estimated number of jobs with a PROGRESSING status.ReservationPlan
— (map
) Details about the pricing plan for your reserved queue. Required for reserved queues and not applicable to on-demand queues.Commitment
— (String
) The length of the term of your reserved queue pricing plan commitment. Possible values include:"ONE_YEAR"
ExpiresAt
— (Date
) The timestamp in epoch seconds for when the current pricing plan term for this reserved queue expires.PurchasedAt
— (Date
) The timestamp in epoch seconds for when you set up the current pricing plan for this reserved queue.RenewalType
— (String
) Specifies whether the term of your reserved queue pricing plan is automatically extended (AUTO_RENEW) or expires (EXPIRE) at the end of the term. Possible values include:"AUTO_RENEW"
"EXPIRE"
ReservedSlots
— (Integer
) Specifies the number of reserved transcode slots (RTS) for this queue. The number of RTS determines how many jobs the queue can process in parallel; each RTS can process one job at a time. When you increase this number, you extend your existing commitment with a new 12-month commitment for a larger number of RTS. The new commitment begins when you purchase the additional capacity. You can't decrease the number of RTS in your reserved queue.Status
— (String
) Specifies whether the pricing plan for your reserved queue is ACTIVE or EXPIRED. Possible values include:"ACTIVE"
"EXPIRED"
Status
— (String
) Queues can be ACTIVE or PAUSED. If you pause a queue, the service won't begin processing jobs in that queue. Jobs that are running when you pause the queue continue to run until they finish or result in an error. Possible values include:"ACTIVE"
"PAUSED"
SubmittedJobsCount
— (Integer
) The estimated number of jobs with a SUBMITTED status.Type
— (String
) Specifies whether this on-demand queue is system or custom. System queues are built in. You can't modify or delete system queues. You can create and modify custom queues. Possible values include:"SYSTEM"
"CUSTOM"
-
(AWS.Response)
—
Returns: