概覽
有關Zencoder支持的HDR格式的詳細信息以及有關HDR格式參數的建議，請參閱HDR視頻指南。
reserve_hdr_metadata
master_display:Boolean
API 版本：V2
上級：輸出
默認：假
兼容的工作類型：伏特
描述：
設置為true時，此參數指示Zencoder從輸入文件中導入（大多數或全部）與HDR相關的元數據，並將它們傳遞給輸出。
例如，可以通過使用以下作業請求來完成HDR10，PQ10或HLG10格式的HEVC編碼視頻流的轉碼：
{
"input": "s3://mybucket/hdr_master.mp4",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"preserve_hdr_metadata": true
}
]
}此參數也可以與其他參數結合使用，直接指定與HDR相關的元數據。例如，下面的JSON作業請求顯示了preserve_hdr_metadata參數也可以用於結轉master display和content light level來自HEVC編碼的DolbyVision 8.1流的元數據，而DolbyVision動態元數據（RPU文件）通過使用dolby_vision_rpu_url參數分別進行通信：
{
"input": "s3://mybucket/dv81_master.mp4",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "dv8.1",
"preserve_hdr_metadata": true,
"dolby_vision_rpu_url": "s3://mubucket/dv81_master_rpu.rpu"
}
]
}也可以看看：
hdr_format
hdr_format:String
API 版本：V2
父母：outputs，dynamic_profile_options
有效值：hdr10，pq，hlg，dv5，dv8.1
默認：沒有
兼容的工作類型：伏特
描述：
指定用於產生輸出的HDR格式的類型。
如果輸入文件不攜帶與HDR格式相關的元數據，因此格式類型和所有相關的元數據都需要直接指定，則應使用此參數。
例如，可以通過以下作業請求將作為J2K編碼的MFX提供的PQ顏色分級的內容轉換為PQ10輸出流：
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "pq"
}
]
}要么。如果同一個J2K MXF主文件代表HDR10內容，並隨附描述其內容的其他文件主顯示和內容亮度元數據參數，然後在HDR10 HEVC流中對其進行編碼可以通過使用以下作業請求來完成：
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "hdr10",
"master_display": {
"red": {"x": 0.708, "y": 0.292},
"green": {"x": 0.17, "y": 0.797},
"blue": {"x": 0.131, "y": 0.046},
"white_point": {"x": 0.31273,"y": 0.329},
"luminance": {"max": 1000,"min": 0.0001}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
也可以看看：
master_display
master_display:Object
API 版本：V2
父母：outputs，dynamic_profile_options
默認：沒有
兼容的工作類型：伏特
描述：
描述用於掌握視頻內容的顯示器的色量（原色，白點和亮度範圍）的結構。此結構中使用的特定值定義為SMPTE ST 2086標準。
主顯示元數據是強制性的，並且在以HDR-10和DolbyVision 8.1格式對視頻進行編碼時，必須對輸出執行這些操作。
以下示例顯示瞭如何指定主顯示元數據：
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "hdr10",
"master_display": {
"red": {"x": 0.708, "y": 0.292},
"green": {"x": 0.17, "y": 0.797},
"blue": {"x": 0.131, "y": 0.046},
"white_point": {"x": 0.31273,"y": 0.329},
"luminance": {"max": 1000,"min": 0.0001}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
也可以看看：
最大內容 _ 亮度 _ 圖層
max_content_light_level:Number
API 版本：V2
父母：outputs，dynamic_profile_options
默認：沒有
有效值：0-10000
兼容的工作類型：伏特
例：1000
描述：
描述整個視頻序列的最大像素（以及紅色，綠色和藍色通道）方式的光照水平。以坎德拉每米平方表示。可以將該值設置為0，表示此邊界未知或未施加。此參數，也稱為MaxCLL由CAE 861.3標準。
以下示例顯示了max_content_light_level和max_frame_average_light_level可以指定元數據：
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "hdr10",
"master_display": {
"red": {"x": 0.708, "y": 0.292},
"green": {"x": 0.17, "y": 0.797},
"blue": {"x": 0.131, "y": 0.046},
"white_point": {"x": 0.31273,"y": 0.329},
"luminance": {"max": 1000,"min": 0.0001}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}也可以看看：
最大框架 _ 平均 _ 亮度 _ 圖層
max_frame_average_light_level:Number
API 版本：V2
父母：outputs，dynamic_profile_options
默認：沒有
有效值：5.0-10000.0
兼容的工作類型：伏特
例：180
描述：
描述整個視頻序列的最大幀平均（以及最大的紅，綠和藍通道方式）光水平。以坎德拉每米平方表示。可以將該值設置為0，表示此邊界未知或未施加。此參數，也稱為MaxFALL由CAE 861.3標準。
這倆max_content_light_level和max_frame_average_light_level以HDR-10格式編碼視頻時，這些參數是必填參數，並且必須包含在輸出中。
以下示例顯示了max_content_light_level和max_frame_average_light_level可以指定元數據：
{
"input": "s3://mybucket/j2k_master.mfx",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "hdr10",
"master_display": {
"red": {"x": 0.708, "y": 0.292},
"green": {"x": 0.17, "y": 0.797},
"blue": {"x": 0.131, "y": 0.046},
"white_point": {"x": 0.31273,"y": 0.329},
"luminance": {"max": 1000,"min": 0.0001}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}也可以看看：
dolby_vision_rpu_url
dolby_vision_rpu_url:String
API 版本：V2
父母：outputs，dynamic_profile_options
默認：沒有
兼容的工作類型：伏特
描述：
在對DolbyVision 5和DolbyVision 8.1格式的視頻進行代碼轉換時，當前需要此參數。
用法示例：
{
"input": "s3://mybucket/dv5_master.mp4",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "dv5",
"video_color_range": "full",
"dolby_vision_rpu_url": "s3://mubucket/dv5_master_rpu.rpu"
}
]
}也可以看看：
video_color_range
video_color_range:String
API 版本：V2
父母：outputs，dynamic_profile_options
有效值：limited，full
默認：沒有
兼容的工作類型：伏特
描述：
指示像素值的動態範圍。例如，對於8位像素，limited表示Y（亮度）像素值將保持在16到235的範圍內，而full表示Y（亮度）像素值的範圍是0到255。
目前，絕大多數內容都是使用以下方式製作和編碼的limited像素。然而full範圍像素有時也可以使用。例如，以DolbyVision 5格式使用10位寬的全範圍像素。
用法示例：
{
"input": "s3://mybucket/dv5_master.mp4",
"outputs": [
{
"video_codec": "hevc",
"video_codec_profile": "main10",
"video_bit_depth": 10,
"hdr_format": "dv5",
"video_color_range": "full",
"dolby_vision_rpu_url": "s3://mubucket/dv5_master_rpu.rpu"
}
]
}也可以看看：
紅
red:Object
API 版本：V2
上級： master_display
默認：沒有
兼容的工作類型：伏特
描述：
散列包含紅色的顏色量設置。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
X
x:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.7400
兼容的工作類型：伏特
例：0.708
描述：
顏色音量 x 設置為紅色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
ÿ
y:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.8400
兼容的工作類型：伏特
例：0.292
描述：
顏色音量 y 設置為紅色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
綠色
green:Object
API 版本：V2
上級： master_display
默認：沒有
兼容的工作類型：伏特
描述：
哈希值包含綠色的音量設置。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
X
x:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.7400
兼容的工作類型：伏特
例：0.17
描述：
顏色音量 x 設置為綠色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
ÿ
y:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.8400
兼容的工作類型：伏特
例：0.797
描述：
顏色音量 y 設置為綠色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
藍色
blue:Object
API 版本：V2
上級： master_display
默認：沒有
兼容的工作類型：伏特
描述：
散列包含藍色的顏色量設置。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
X
x:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.7400
兼容的工作類型：伏特
例：0.131
描述：
顏色音量 x 設置為藍色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
ÿ
y:Number
API 版本：V2
默認：沒有
有效值：0.0001-0.8400
兼容的工作類型：伏特
例：0.046
描述：
顏色音量 y 設置為藍色。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
white_point
white_point:Object
API 版本：V2
上級： master_display
默認：沒有
兼容的工作類型：伏特
描述：
包含white_point的顏色量設置的哈希值。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
X
x:Number
API 版本：V2
上級： master_display：white_point
默認：沒有
有效值：0.0001-0.7400
兼容的工作類型：伏特
例：0.31273
描述：
色彩量x white_point的設置。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
ÿ
y:Number
API 版本：V2
上級： master_display：white_point
默認：沒有
有效值：0.0001-0.8400
兼容的工作類型：伏特
例：0.329
描述：
white_point的色度y設置。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
亮度
luminance:Object
API 版本：V2
上級： master_display
默認：沒有
兼容的工作類型：伏特
描述：
包含亮度設置的哈希值。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
分
min:Number
API 版本：V2
默認：沒有
有效值：0.0001-5.0
兼容的工作類型：伏特
例：0.0001
描述：
最小亮度nits or candelas per square meter (cd/m2)。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}
最高
max:Number
API 版本：V2
默認：沒有
有效值：5.0-10000.0
兼容的工作類型：伏特
例：1000
描述：
最大亮度nits or candelas per square meter (cd/m2)。
{
"input": "s3://mybucket/hdr_master.mov",
"outputs": [
{
"video_codec": "hevc",
"video_bit_depth": 10,
"master_display": {
"red": {
"x": 0.708,
"y": 0.292
},
"green": {
"x": 0.17,
"y": 0.797
},
"blue": {
"x": 0.131,
"y": 0.046
},
"white_point": {
"x": 0.31273,
"y": 0.329
},
"luminance": {
"max": 1000,
"min": 0.0001
}
},
"max_content_light_level": 1000,
"max_frame_average_light_level": 180
}
]
}