Ingest Profiles Fields Reference

Profile fields

Top-Level Profile Options
Property	Type	Description	DD	Default
`id`	string	The profile id (read-only)		none
`version`	integer	The profile version (read-only)		none
`account_id`	integer	The Video Cloud account id		none
`name`	string	The profile name - must be unique within the account		none
`description`	string	The profile description		none
`date_created`	integer (epoch timestamp (milliseconds)	Date profile was created (read-only)		none
`date_last_modified`	integer (epoch timestamp in milliseconds)	Date profile was last modified (read-only)		none
`brightcove_standard`	boolean	Read-only - `false` for all custom profiles	false
`digital_master`	object	Defines if and how to archive a digital master		{}
`dynamic_origin`	object	Defines renditions and images		{}
`renditions`	array	Array of rendition objects; not used for DD or CAE, so will be an empty array for these profiles		[]

Digital master fields

The digital_master object defines if and how to store a digital master that you can use for retranscoding later. See Archiving Masters for details.

Digital Master Fields
Property	Type	Description	DD	CAE	Default
`rendition`	string	The rendition to archive - either `passthrough` or `none` are the only options for DD and CAE profiles			passthrough
`distribute`	boolean	Whether the digital_master should be pushed to the CDN to available for playback; this option does not currently work for DD or CAE profiles and will revert to `false` if you set it to `true`			false

Dynamic Origin Fields

Dynamic Origin Fields
Property	Type	Description	DD	Default
`renditions`	array	Array of renditions to be produced; for CAE, only include any audio-only renditions you want. See the available renditions you can select from	[]
`images`	array	Array of image objects for the poster and thumbnail		[]
`dynamic_profile_options`	object	Defines rendition options for CAE profiles		{}

Image fields

Image Fields
Property	Type	Description	Default
`label`	string	The image type: either `poster` or `thumbnail`	none
`height`	number	Height of the image in pixels	none
`width`	number	Width of the image in pixels	none

Dynamic Profile Options Fields

The dynamic profile options fields provide guidelines for rendition creation when you are using Context Aware Encoding.

Dynamic Profile Options
Property	Type	Description	CAE	Default
`deinterlace`	String	Determines whether or not to apply a deinterlacing filter. Default is `detect` – if the input file is detected as interlaced, it will be deinterlaced. Set this to `on` to force deinterlacing (which will reduce quality if the input is not interlaced), or `off` to avoid deinterlacing.		`detect`
`deinterlace_mode`	String	If not included or set to `frame-to-frame`, Video Cloud outputs will match the framerate of the input file. If set to `field-to-frame`, Video Cloud will double the framerate of the input file for the output. If you manually set framerate to double the framerate of the input file, Video Cloud will automatically set `deinterlace_mode` to `field-to-frame` and double the framerate for the output.		`frame-to-frame`
`video_codecs`	Array	For mixed-codec outputs, an array of the codecs to create renditions for. Currently, the allowed item values are `h264` and `hevc`	^[2-1]	none
`video_codec_options`	Array	For mixed-codec outputs, an object specifying the options for each codec. Each property is an object with the name `h264` or `hevc`, its properties are the set the constraints for renditions for that codec. The allowed properties for these objects are: `min_renditions` required `min_bitrate` `max_bitrate` `max_first_rendition_bitrate` `min_resolution` `max_resolution` `max_first_rendition_resolution` Note: these settings are also used at the global level. When you are using settings both at the global and per-codec levels, the values must be compatible. For example, max_renditions set at the global level must be greater than or equal to the sum of min_rendition values set at the per-codec level	^[2-2]	none
`min_renditions`	Number	The minimum number of renditions that should be created (required)		none
`max_renditions`	Number	The maximum number of renditions that should be created (required)		none
`min_resolution`	object	The minimum resolution for renditions		none
`min_resolution.width`	number	The minimum width for renditions in pixels		none
`min_resolution.height`	number	The minimum height for renditions in pixels		none
`max_resolution`	object	The maximum resolution for renditions		defaults to source resolution
`max_resolution.width`	number	The maximum width for renditions in pixels		source width
`max_resolution.height`	number	The maximum height for renditions in pixels		source height
`max_bitrate`	number	The maximum bitrate for renditions in kbps		source bitrate
`max_first_rendition_bitrate`	number	The maximum bitrate for the lowest bitrate rendition in kbps		source bitrate
`max_frame_rate`	number	The maximum frame rate for renditions in fps		30
`keyframe_rate`	number	The number of keyframes per second for renditions (So a value of 0.5 would result in one keyframe every two seconds; a value of 3 would result in three keyframes per second)		0.5
`select_baseline_profile_configuration`	boolean	At least one rendition used in the profile will be baseline profile		false
`select_distinct_configurations`	boolean	If true, CAE will ensure that no two renditions use the same combination of: resolution, frame rate, and codec profile		false
`watermarks`	array	Array of watermark objects specifying one or more watermarks to be added to renditions		false
`video_color_range`	string	Indicates the dynamic range of pixel values. For example, for 8-bit pixels, `limited` implies that Y (luma) pixel values will stay in the range from 16 to 235, while `full` implies that Y (luma) pixel values will be in range from 0 to 255. The vast majority of content is currently produced and encoded using `limited` pixels. However full-range pixels may also be sometimes used. For example, 10-bit-wide full-range pixels are used in the DolbyVision 5 format.		none

Notes

^[2-1] Required if video_codec_options is present. See HEVC Video for more information.

^[2-2] Required if video_codecs is present. See HEVC Video for more information.

Watermark Fields

Watermark images are burned into each video frame in the lower right corner.

Watermark Sample

Property	Type	Description	Default
`url`	string	url for the image	none
`width`	string^[3-2]	width of the watermark as pixels or a percentage of the frame width - e.g. `"20%"`^[3-1]	none
`height`	string^[3-2]	height of the watermark as pixels or a percentage of the frame height - e.g. `"10%"`^[3-1]	none
`x`	string^[3-2]	distance from the left edge of the video frame to the center of the watermark as pixels or a percentage of the frame width	none
`y`	string^[3-2]	distance from the top edge of the video frame to the center of the watermark as pixels or a percentage of the frame width	none

Notes

^[3-1] If you specify the width only, the image aspect ratio will be maintained automatically
^[3-2] Although the width, height, x, and y fields are string values and must be enclosed in double-quotes; they contain numbers (pixels or percentage)