編碼設定

本主題提供所有編碼設定的表格，其中包含每個設定詳細指南的連結。

工作

設定 預設 描述
api_key 無 您的Zencoder帳戶的API密鑰。
dynamic_profile_options 無 使用CAE，可以為每個輸入文件動態更改輸出數量和此類輸出的參數。動態設定定義應該建立轉譯的方式。
generate_dynamic_profile 假的 使用CAE，可以為每個輸入文件動態更改輸出數量和此類輸出的參數。
input 無 一個 HTTP，S3，雲文件，GCS，FTP，FTPS，SFTP，Azure，或阿斯佩拉的 URL，我們可以下載文件轉碼。
outputs 無 輸出設置的數組或散列。
region 我們 處理檔案的區域：美國、歐洲、亞洲或澳洲。
test 假的 啟用工作的測試模式 (「整合模式」)。
private 假的 為工作啟用隱私模式。
download_connections 5 利用多個同時連線進行下載加速 (在某些情況下)。
pass_through 無 與該作業一起存儲的可選信息。
mock 假的 傳送模擬的工作請求。
grouping 無 此工作的報表群組。
aspera_transfer_policy 公平 如何配置 Aspera 檔案傳輸的可用頻寬。
transfer_minimum_rate +1000 以 Kbps 為單位的資料傳輸最低限度的目標速率。
transfer_maximum_rate +250000 資料傳輸上限的 Kbps 目標速率。
expected_md5_checksum 無 輸入檔案的預期總和檢查碼。
credentials 無 以暱稱參考已儲存的認證。

一般輸出設定

設定 預設 描述
type 標準 要輸出的檔案類型。
label 無 此輸出的選擇性標籤。
dynamic_profile_rendition 無 dynamic_profile_rendition 設定指定此輸出應使用動態產生的 CAE 描述檔中的設定，特別是要使用設定檔的設定。
url 無 一個 S3，雲文件，GCS，FTP，FTPS，SFTP，SFTP，亞斯佩拉，Azure，HTTP，或 RTMP 網址，我們將放在轉碼的文件。
secondary_url 無 一個 S3，雲文件，GCS，FTP，FTPS，SFTP，HTTP，RTMP，阿斯佩拉，或 Azure 的 URL，我們將放在轉碼的文件。
base_url 無 一個基本的 S3，雲文件，GCS，FTP，FTPS，SFTP，Azure，或阿斯佩拉目錄 URL，我們將把轉碼的文件，沒有文件名。
filename 無 完成檔案的檔案名稱。
package_filename 無 打包輸出的文件名。
package_format 無 用於輸出檔案的 ZIP/封裝格式。
device_profile 無 用於行動裝置相容性的裝置描述檔。
strict 假的 啟用嚴謹模式。
skip_video 假的 請勿輸出視訊軌道。
skip_audio 假的 請勿輸出音軌。
source 無 參考另一個工作上的標籤，並使用該輸出建立的視訊進行處理，而不是輸入檔案。
credentials 無 以暱稱參考已儲存的認證。
generate_md5_checksum 假的 生成輸出文件的 MD5 校驗和。
parallel_upload_limit S3為30，其他所有目的地為10。 嘗試同時上傳的最大次數。
headers 無 當我們上傳文件時與文件一起發送的HTTP標頭。

CAE 設定

設定 預設 描述
min_renditions 1 生成的最小演繹數。
The maximum number of renditions to generate 8 生成的最大演繹數。
min_resolution 192x108 梯子要考慮的最小分辨率。
max_resolution 來源解析度 階梯要考量的最大解析度。
max_frame_rate +30 可以使用的最大影格速率。
keyframe_rate +0.5 關鍵影格速率。這個值可以是 0.5 或 1。若為啟用 SSAI 的內容，此值必須為 1。
fixed_frame_rate 真正 指示產生器在所有轉譯中使用相同的影格速率。如果為 false，則以低於 360p 解析度的 H.264 基準描述檔轉譯將會被指定為一半的影格速率。
min_bitrate 200 可以使用的最小位元速率 [kbps]。
max_bitrate +15000 可以使用的最大位元速率 [kbps]。
max_first_rendition_bitrate 400 可用於第一次轉譯的最大位元速率 [kbps]。
min_granularity +30 轉譯之間位元速率的最小相對變更。
max_granularity +90 轉譯之間位元速率的最大相對變更。
video_codec h264 要使用的視訊轉碼器。
bitrate_cap_to_bitrate_ratio +1.3 用於 VBR 編碼的最大位元速率與平均位元速率的比率。
buffer_size_to_bitrate_ratio +2.0 用於 VBR 編碼的解碼器緩衝區大小與平均位元率的比率。
bitrate_cap_offset +64 計算最大位元速率時增加常數。
buffer_size_offset +85 計算 VBV 緩衝區大小時增加的常數。
quality_rate_tune 0 品質與速率調整參數。
select_baseline_profile_configuration 真正 縱斷面中使用的至少一個節目將是基準線縱斷面。
video_configurations 沒有 描述解析度、影格速率和相關的轉碼器設定的結構陣列，應優先或強制產生為 CAE 編碼的一部分。

格式與轉碼器

設定 預設 描述
format 由輸出文件名然後由視頻或音頻編解碼器確定。否則：mp4（用於標準輸出）； ts（用於分段輸出）。 要使用的輸出格式。
video_codec 由格式，配置文件或audio_codec。 h264（如果未提供）。 要使用的視訊轉碼器。
audio_codec 由格式，配置文件或video_codec。 AAC（如果未提供）。 要使用的音頻編解碼器。

解析度

設定 預設 描述
size 無 輸出視訊的解析度 (WxH，以像素為單位)。
width 無 輸出視訊的最大寬度 (以像素為單位)。
height 無 輸出視訊的最大高度 (以像素為單位)。
upscale 假的 如果輸入小於目標輸出解析度，則升頻輸出。
aspect_mode 保留 當輸入文件的縱橫比與目標寬度/高度縱橫比不匹配時該怎麼辦。
sample_aspect_ratio 無 用於輸出視頻的樣本（像素）長寬比。大小，寬度，高度和aspect_mode模式選項均指編碼像素尺寸，而不是顯示尺寸。
force_interlace_headers 假 一些解碼器要求隔行掃描的內容，但是可以播放逐行掃描的內容。此設置會將“隔行掃描”標頭添加到漸進式內容的元數據中，以使其看起來像實際上是隔行掃描的。

匯率控制

設定 預設 描述
quality 3 自動選取符合目標視覺品質的最佳視訊位元速率。
video_bitrate 無 以 kbps 為單位的目標視訊位元速率。如果您選取品質設定，則不需要，除非您要以特定位元速率為目標。
audio_quality 3 自動選擇最佳音訊位元率以符合目標音質。
audio_bitrate 無 以 kbps 為單位的目標音訊位元率。如果選擇一個，則不需要audio_quality設置，除非您要指定特定的比特率。
max_video_bitrate 無 最大平均位元速率。
speed 3 目標轉碼速度。較慢的編碼通常允許更高級的壓縮。
decoder_bitrate_cap 無 提供給解碼器緩衝區的最大位元率。通常用於旨在流式傳輸的視頻或用於定位特定設備的視頻（例如，Blu-Ray）。
decoder_buffer_size 無 解碼器緩衝區的大小，與bitrate_cap。
one_pass 假的 強制單次編碼。
audio_constant_bitrate 假的 如果可能的話，啟用固定位元速率模式。

影格速率

設定 預設 描述
frame_rate 原始（輸入）幀速率。 要使用的影格速率。
max_frame_rate 無 要使用的最大影格速率。
decimate 無 通過除數減少輸入幀速率。
keyframe_interval 250 每個關鍵影格之間的最大影格數目。對於 H.264 視訊，關鍵影格為 IDR 影格。
keyframe_rate keyframe_interval一百五十 每秒的關鍵影格數目。
fixed_keyframe_interval 假的 啟用固定關鍵影格間隔模式 (僅限 VP6、VP8、VP9 和 H.264)。
forced_keyframe_interval 無 以指定的間隔強制關鍵影格 (僅限 H.264)。
forced_keyframe_rate 無 指定每秒的關鍵影格數目，並考慮影格速率 (僅限 H.264)。
generate_frame_index 假的 產生視訊影格索引檔案。
frame_index_filename 無 在以下情況下覆蓋幀索引的默認文件名generate_frame_index已啟用。

視訊

設定 預設 描述
video_reference_frames 3 要使用的一些參考框架（H.264，HEVC）。
video_codec_profile H.264：基線，HEVC：主要，VP9： 0 要使用的視訊轉碼器設定檔 (H.264、HEVC、VP9)。
video_codec_level 使用基於輸出視頻的水平圖自動計算。看到H.264-levels，HEVC-levels 要使用的視訊轉碼器層級 (H.264、HEVC)。
video_bframes 0 連續 B 影格的最大數目 (H.264, HEVC)
color_metadata 保留 保留或捨棄輸出視訊中輸入的色彩中繼資料資訊。

音訊

設定 預設 描述
audio_sample_rate 無 音訊取樣率 (以 Hz 為單位)。
max_audio_sample_rate 無 最大音訊取樣率 (以 Hz 為單位)。
audio_channels 如果原始文件是mono，則為1；否則為1。否則2。 音訊頻道數量：1 或 2.
audio_bit_depth +16 每個樣本的位元數：16、24、32。
audio_language 無 說明音軌的語言。
input_audio_channels 無 設定輸入音訊軌道至頻道配置。
output_audio_channels 無 設定輸出音訊頻道佈局。

縮圖

設定 預設 描述
thumbnails 無 擷取指定視訊的縮圖。
label 無 用於識別每組縮圖群組的標籤。
format PNG 縮略圖的格式。
number 無 一些縮圖，間距均勻。
start_at_first_frame 假的 從第一個影格開始產生縮圖。
interval 無 以均勻的間隔（以秒為單位）拍攝縮略圖。
interval_in_frames 無 以均勻的間隔以幀為單位拍攝縮略圖。
times 無 擷取縮圖的次數，以秒為單位。
aspect_mode 保留 如何處理與輸入文件的縱橫比不同的縮略圖寬度/高度。
size 無 縮略圖分辨率為WxH。
width 無 縮圖的最大寬度 (以像素為單位)。
height 無 縮圖的最大高度 (以像素為單位)。
base_url 無 一個基本的 S3，雲文件，GCS，FTP，FTPS 或 SFTP 目錄 URL，我們將在其中放置縮略圖，沒有文件名。
prefix 框架 縮圖檔案名稱的前置詞。
filename 框架 內插縮圖檔案名稱。
public 假的 使輸出在 S3 上公開可讀。
access_control 無 傳送至 S3 的檔案的精細存取控制規則。
grantee 無 設定精細 S3 存取控制權限的受權者。
permission 無 在使用細微的存取控制時，設定受權者的權限。
rrs 假的 亞馬遜 S3 的減少備援儲存。
headers 無 HTTP headers在我們上傳縮略圖時發送。
credentials 無 以暱稱參考已儲存的認證。
parallel_upload_limit S3為30，其他所有目的地為10。 嘗試同時上傳的最大次數。

浮水印

設定 預設 描述
watermarks 無 在輸出視訊中新增一或多個浮水印。
url 無 用作水印的遠程圖像文件的URL。
x -+10 在哪裡放置浮水印，在 x 軸上。
y -+10 放置浮水印的位置，在 y 軸上。
width 縮放到高度，或原始圖像寬度。 浮水印的縮放寬度。
height 縮放到寬度或原始圖像高度。 浮水印的縮放高度。
origin 內容 輸出的哪個部分以基於浮水印位置。
opacity +1.0 使浮水印透明。

字幕

設定 預設 描述
caption_url 無 要包含在輸出中的 SCC、DFXP 或 SAMI 標題檔案的 URL。
skip_captions 假的 不要在輸出文件中添加標題或將標題傳遞給輸出文件。

視訊處理

設定 預設 描述
rotate 自動偵測 旋轉視訊。
deinterlace 偵測 去交錯輸入視訊。
sharpen 假的 套用銳利化濾鏡。
denoise 無 套用去除濾鏡。
autolevel 假的 套用色彩自動層級過濾條件。
deblock 假的 套用解除區塊篩選器。

音訊處理

設定 預設 描述
audio_gain 無 將增益量應用於音頻，以 dB 為單位。
audio_normalize 假的 將音頻標準化為0dB。
audio_pre_normalize 假的 在應用擴展或壓縮效果之前，請對音頻進行標準化。
audio_post_normalize 假的 應用擴展或壓縮效果後，對音頻進行標準化。
audio_bass 無 增加或減少音訊中的低音量。
audio_treble 無 增加或減少音訊中的高音量。
audio_highpass 無 將高通濾波器套用至音訊。
audio_lowpass 無 將低通濾波器套用至音訊。
audio_compression_ratio 無 壓縮音訊的動態範圍。
audio_compression_threshold -+20 壓縮音訊的動態範圍。
audio_expansion_ratio 無 擴展音訊的動態範圍。
audio_expansion_threshold -+35 擴展音訊的動態範圍。
audio_fade 無 將淡入和淡出效果套用至音訊。
audio_fade_in 無 將淡入效果套用至音訊。
audio_loudness_level 無 調整音訊的音量等級。
audio_karaoke_mode 假的 在音訊上套用卡拉 OK 效果。

短片

設定 預設 描述
start_clip 無 透過設定自訂開始時間，僅對輸入檔案的一部分進行編碼。
clip_length 無 透過設定自訂剪輯片段長度，僅對輸入檔案的一部分進行編碼。

S3 設定

設定 預設 描述
public 假的 使輸出在 S3 上公開可讀。
rrs 假的 亞馬遜 S3 的減少備援儲存。
access_control 無 傳送至 S3 的檔案的精細存取控制規則。
grantee 無 設定精細 S3 存取控制權限的受權者。
permission 無 使用細粒度的 access_Control 時，設定受權者的權限。

通知

設定 預設 描述
notifications 無 工作或輸出完成時收到通知。
url 無 工作或輸出完成時收到通知。
format 無 通知的格式和內容類型。
headers 無 要在 HTTP 通知上傳遞的標頭。

條件輸出

設定 預設 描述
min_size 無 如果來源尺寸小於指定尺寸，則略過輸出。
max_size 無 如果來源維度大於指定尺寸，則略過輸出。
min_duration 無 跳過輸出，如果源持續時間比給定的持續時間短，以秒為單位。
max_duration 無 如果源持續時間長於給定的持續時間，則略過輸出，以秒為單位。
min_audio_bitrate 無 如果來源音訊位元速率小於指定的位元速率 (以 kbps 為單位)，則略過輸出。
max_audio_bitrate 無 如果來源音訊位元速率大於指定的位元率 (以 kbps 為單位)，則略過輸出。
min_video_bitrate 無 如果來源視訊位元速率小於指定的位元速率 (以 kbps 為單位)，則略過輸出。
max_video_bitrate 無 如果來源視訊位元速率大於指定的位元速率 (以 kbps 為單位)，則略過輸出。
require_audio 假的 如果來源檔案不包含音軌，則略過輸出。
require_video 假的 如果源文件不包含視頻軌，則跳過輸出。

分段串流

設定 預設 描述
streaming_delivery_format 無 設置可串流輸出的格式/協議配置。
streaming_delivery_profile 生活 設定串流傳遞格式的特定設定檔。
playlist_format 無 設定播放清單輸出的格式。
segment_seconds +10 設置分段輸出中每個分段的最大持續時間。
alternate_audio 無 為 HLS 播放清單提供一組替代音訊串流。
streams 無 提供要重新格式化為播放清單的串流資訊清單
path 無 指定流清單文件的路徑
bandwidth 無 指定播放清單流的頻寬
resolution 無 指定播放清單流的解析度
codecs 無 指定播放清單串流中使用的轉碼器
audio 無 指定播放列表的備用音軌。
segment_image_url 無 要在僅音訊區段上顯示的影像
segment_video_snapshots 假的 將視頻文件分段為純音頻分段時，請為每個分段拍攝視頻快照作為縮略圖。
source 無 指定播放清單串流的來源媒體
max_hls_protocol_version 3 表示即時輸出，5 表示樣本 AES 加密；否則為 2。 要使用的最大 HLS 通訊協定。
hls_optimized_ts 真正 在 iOS 上針對 HTTP 即時串流最佳化 TS 區段檔案。
prepare_for_segmenting 無 包含字幕和關鍵影格時間以進行分段。
smil_base_url 無 新增 至 SMIL 播放清單的區段。
byte_range_segmenting 假的 設定 HLS 分段以產生單一輸出檔案，而不是每個區段一個檔案。
generate_keyframe_manifest 假的 產生快轉和反向播放所需的 HLS 關鍵影格 (i-frame) 資訊清單。
keyframe_manifest_filename 框架索引 覆寫 HLS 關鍵影格資訊清單的預設檔案名稱。
allow_skipped_sources 假的 忽略以下來源有條件的輸出已被跳過。

加密

設定 預設 描述
encryption_method 無 設置用於加密的加密方法。
encryption_key 無 設定要使用的單一加密金鑰，而不是讓 ZenCoder 產生一個加密金鑰
encryption_key_url 無 將 URL 設定為單一加密金鑰使用，而不是讓 Zencoder 產生
encryption_key_rotation_period 無 在多個區段後旋轉至新的加密金鑰
encryption_key_url_prefix 無 使用傳遞的字符串前加密鍵 URL
encryption_iv 無 設置加密時要使用的初始化向量
encryption_password 無 設置用於生成初始化向量的密碼

解密

設定 預設 描述
decryption_method aes-128-cbc（如果decryption_key要么decryption_key_url設置） 設定要使用的解密演算法。
decryption_key 無 設定要使用的解密金鑰。
decryption_key_url 無 要使用的解密金鑰檔案的 URL。
decryption_password 無 與密鑰結合使用的密碼，用於解密輸入文件。

DRM

設定 預設 描述
drm {} DRM 選項的雜湊
method 無 用於保護內容的數字版權管理（DRM）方法。
provider 無 使用的數字版權管理（DRM）提供程序。
key_id 無 要使用的密鑰的標識符。
key_guid 無 要使用的密鑰的標識符。
user_key 無 DRM提供程序的用戶密鑰。
server_key 無 來自DRM提供程序的服務器密鑰。
media_id 無 媒體的唯一標識符。
content_id 無 內容的唯一標識符。
content_key 無 內容的唯一標識符。
schemas 無 使用一般加密時，DRM 提供者的相關資訊。
type 無 此DRM架構的提供程序類型。
license_acquisition_url 無 的許可證獲取URL Playready CENC DRM模式。

H.264

設定 預設 描述
h264_reference_frames 3 要在 H.264 視訊中使用的一些參考框架。
h264_profile 基準線 > 要使用的 H.264 設定檔。
h264_level 自動計算使用H.264電平圖根據輸出的視頻。 要使用的 H.264 等級。
h264_bframes 0 連續 B 影格的最大數目。
crf 無 位元速率控制設定。

HDR10

設定 預設 描述
master_display.red.x 無 顏色音量 x 設置為紅色。
master_display.red.y 無 顏色音量 y 設置為紅色。
master_display.green.x 沒有。 顏色音量 x 設置為綠色。
master_display.green.y 沒有。 顏色音量 y 設置為綠色。
master_display.blue.x 沒有。 顏色音量 x 設置為藍色。
master_display.blue.y 沒有。 顏色音量 y 設置為藍色。
master_display.white_point.x 沒有。 白點的顏色音量 x 設定。
master_display.white_point.y 沒有。 白點的顏色音量 y 設定。
master_display.luminance.min 沒有。 每平方公尺 (cd/m2) 以尼特或新燭光為單位的最小明度。
master_display.luminance.max 沒有。 每平方公尺 (cd/m2) 以尼特或新燭光為單位的最大亮度。
max_content_light_level 沒有。 每平方米（cd/m2）的內容的最大光級別（cd/m2）-整數值。
max_frame_average_light_level 沒有。 每平方公尺 (cd/m2) 內容幀 nto 或新燭光的最大平均光級-整數值。雖然允許多達 10000 的值，但 100-200 範圍內的值通常會產生最佳的結果。

FLV

設定 預設 描述
cue_points 無 將事件或導覽提示點新增至 FLV 視訊。
type 無 提示點類型。
time 無 提示點時間，以秒為單位。
name 無 提示點名稱。
data 無 提示點資料。

VP6

設定 預設 描述
vp6_temporal_down_watermark 20 VP6 暫時向下浮水印百分比。
vp6_temporal_resampling 當每個像素的位數較少時編碼為true。否則為假。 啟用或停用 VP6 暫時重新取樣。
vp6_undershoot_pct +90 以稍低一點的數據圖表為目標。
vp6_profile vp6e VP6 設定檔：vp6s 或 vp6e。
vp6_compression_mode 好 VP6壓縮方式：good要么best。
vp6_2pass_min_section +40 對於雙通 VBR 編碼，編碼器允許的最低數據表。
vp6_2pass_max_section 400 對於雙通 VBR 編碼，編碼器允許的最高數據表。
vp6_stream_prebuffer 6 開始播放前需要的預先載入秒數。
vp6_stream_max_buffer 無 最大解碼器緩衝區大小
vp6_deinterlace_mode 適應的 適用於 VP6 的去交錯模式
vp6_denoise_level 0 標示 VP6 的等級
alpha_transparency 假的 啟用 Alpha 透明度。目前，僅由 VP6 支援。
constant_bitrate 假的 使用常數位元速率 (CBR) 編碼。

MP4

設定 預設 描述
hint 假的 為 RTP/RTSP 啟用 MP4 檔案的提示。
mtu_size +1450 設定 MP4 提示的 MTU 大小。

AAC

設定 預設 描述
max_aac_profile 他-阿克 最先進的 (壓縮) AAC 設定檔允許什麼？
force_aac_profile 無 強制使用特定的AAC配置文件，而不是讓Zencoder為比特率選擇最佳配置文件。

廣播

設定 預設 描述
video_codec_preset 無 預設視頻編碼，以與特定行業標準兼容。
format_preset 無 預設格式，以允許與特定行業標準兼容。
ts_muxrate 無 可以復用傳輸流的最大速率（kbps）。僅與ts格式一起使用。
ts_pmt_pid 無 覆蓋程序映射表的數據包ID。
ts_video_pid 無 覆蓋視頻數據的數據包ID。
ts_audio_pid 無 覆蓋音頻數據的數據包ID。
ts_pcr_pid 無 覆蓋程序時鐘參考的數據包ID。
ts_cbr 假的 通過在傳輸流層填充數據包來創建 CBR 輸出
lossless_video 假的 如果視頻編解碼器支持，則啟用無損視頻編碼。

阿斯佩拉

設定 預設 描述
aspera_transfer_policy 公平 如何配置 Aspera 檔案傳輸的可用頻寬。
transfer_minimum_rate +1000 以 Kbps 為單位的資料傳輸最低限度的目標速率。
transfer_maximum_rate +250000 資料傳輸上限的 Kbps 目標速率。

轉換

設定 預設 描述
copy_video 假的 複製輸入文件的視頻軌道
copy_audio 假的 複製輸入檔案的音軌