quality
quality:Integer
API 版本:V2
上級:outputs
默認:3
有效值:1-5
兼容的工作類型:VOD
例:4
描述:
所需的輸出視頻質量,從1到5。自動選擇video_bitrate以達到此質量。
這會自動選擇產生所需質量視頻的視頻比特率。這很有用,因為由於內容的複雜性,分辨率等原因,一個視頻可能需要比另一個視頻更高的比特率才能達到目標視覺質量。
更高的質量意味著更高的比特率,反之亦然。
質量1:高度壓縮。平庸的視覺質量,但文件很小。
質量2:可接受的質量。
質量3:品質良好。比大多數網絡視頻更好。
質量4:高品質。看起來很棒。
質量5:幾乎無損大型檔案。不建議使用此方法,除非您打算再次對該輸出進行編碼。
根據經驗,將質量降低一個級別將使文件大小減少約40%。較高質量的編碼也比較低質量的編碼慢一些。
請記住,使用質量設置時,輸出比特率會因文件而異,具體取決於視頻的類型。即使在相同的“質量”設置下,低複雜度視頻(如截屏)通常也會比高複雜度視頻(如電影)產生更低的比特率。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"quality": 4
}
]
}
也可以看看:video_bitrate
video_bitrate
video_bitrate:Integer
API 版本:V2
上級:outputs
有效值:一個正整數。最大100000
兼容的工作類型:VOD
例:+1200
描述:
視頻的期望輸出比特率,以kbps表示。這會產生可預測的輸出位元率,但無法預測的品質。例如,在 640x480 下,500kbps 可能足以讓視頻博客看起來不錯,但動作電影在相同的位元率下看起來可能不好。同樣地,對於螢幕擷取來說,它可能太高,導致檔案大於它需要的大。
如果可靠的比特率比可靠的質量更為重要,請選擇video_bitrate。如果可靠的視覺質量更為重要,請使用quality代替。
video_bitrate使用兩次通過的可變比特率(VBR)編碼。 one_pass編碼可以通過one_pass選項,儘管one_pass VBR編碼通常質量較差,並且只會導致較小的加速,因此不建議這樣做。
還請記住,太高或太低的比特率都不可用。默認情況下,如果您指定的比特率太低,我們會自動將其校正為可接受的比特率。啟用strict模式,如果您希望作業在這種情況下失敗而不是自動更正。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"video_bitrate": 1200
}
]
}
也可以看看:quality
audio_quality
audio_quality:Integer
API 版本:V2
上級:outputs
默認:3
有效值:1-5
兼容的工作類型:VOD
例:4
描述:
所需的輸出音頻質量,從1到5。自動選擇一個audio_bitrate達到這種質量。
質量1使用較低的音頻比特率,這會導致較低的聲音質量,但文件較小。質量5可以為較大的文件提供較高的音頻比特率,但質量較高。
對於大多數用途,我們建議使用3;當需要透明音質時,建議使用4-5。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_quality": 4
}
]
}
也可以看看:quality和audio_bitrate
audio_bitrate
audio_bitrate:Integer
API 版本:V2
上級:outputs
有效值:一個正整數。
兼容的工作類型:VOD
例:+96
描述:
輸出比特率設置,以Kbps為單位。對於2聲道輸出,這是總音頻比特率,而不是每個聲道的比特率,因此128kbps立體聲輸出以每個聲道64kbps進行編碼。每個通道低於48kbps時,質量可能會開始下降。
請注意,如果您手動設置audio_sample_rate,則需要選擇兼容的audio_bitrate,否則編碼可能會失敗。默認情況下,我們將自動更正這些故障並選擇有效的比特率/採樣率組合。啟用strict_mode以避免這種自動更正。
此設置不限制編碼視頻的峰值比特率。如果系統檢測到最終的編碼比特率將高於此值,則它將以該比特率作為目標平均比特率在內部重新啟動編碼。看到decoder_bitrate_cap
用於限制峰值比特率。
對於AAC音頻,低於84的比特率將設置AAC檔案到HE-AAC。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_bitrate": 96
}
]
}
max_video_bitrate
max_video_bitrate:Integer
API 版本:V2
上級:outputs
有效值:一個正整數。最大100000
兼容的工作類型:VOD
例:+1500
描述:
影片的最大平均位元率。覆寫品質和 ideo_bitrate 設定,以確保位元速率不會超過提供的數字。
max_video_bitrate在使用quality設置,它會自動選擇一個比特率。行動裝置有時會有固定的位元速率限制;例如,iPhone 3GS 的位元速率限制為 1500 kbps。
注意:此選項與VP6或HEVC編解碼器不兼容。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"max_video_bitrate": 1500
}
]
}
speed
speed:Integer
API 版本:V2
上級:outputs
默認:3
有效值:1-5
兼容的工作類型:伏特
例:4
描述:
目標轉碼速度。較慢的轉檔可以進行更進階的檔案壓縮,而跳過一些進階壓縮功能可以加快轉碼速度。有效值為 1-5。
注意:目前,僅H.264輸出具有五個速度級別。對於VP6內容,1-2是較慢的模式,而3-5是較快的模式。其他視頻編解碼器根本不支持此設置。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"speed": 4
}
]
}
decoder_bitrate_cap
decoder_bitrate_cap:Integer
API 版本:V2
上級:outputs
有效值:一個正整數。最大100000
兼容的工作類型:VOD
例:800
描述:
通過緩衝器饋送到解碼器的最大比特率。此設定通常僅用於串流 (RTMP、HLS 或廣播視訊)。
只有在您瞭解此設定的含意時才使用此設定,因為它會降低視訊品質。
對於實時輸出,默認情況下比實時輸出高15%video_bitrate,如果指定了video_bitrate。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_bitrate_cap": 800
}
]
}
也可以看看: coder_buffer_size
decoder_buffer_size
decoder_buffer_size:Integer
API 版本:V2
上級:outputs
有效值:一個正整數。最大100000
兼容的工作類型:VOD
例:800
描述:
使用 bitrate_cap 時提供給解碼器的緩衝區大小,以 kbps 表示。由比特拉特 _帽除以緩衝區的大小(以秒為單位); 因此,如果將比特拉特 _CAP 設置為 1000 和緩衝區大小為 1000,緩衝區實際上是 1.0 秒。如果位元最大值為 500,而緩衝區大小為 1000,則緩衝區為 2.0 秒。
只有在您瞭解此設定的含意時才使用此設定,因為它會降低視訊品質。這通常應該只用於串流 (或裝置播放)。
對於實時輸出,此默認值是decoder_bitrate_cap的300%,創建的緩衝時間為3秒。但是,如果還設置了segment_seconds,則將減小默認的coder_buffer_size,以使有效緩衝區持續時間為段持續時間的一半。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_buffer_size": 800
}
]
}
也可以看看: coder_bitrate_cap
one_pass
one_pass:Boolean
API 版本:V2
上級:outputs
默認:false
有效值:true
要么false
兼容的工作類型:伏特
例:true
描述:
默認情況下,每當編碼到目標時,我們都會使用兩次編碼video_bitrate和執行常量時的one_pass編碼quality編碼(無法從第二遍中受益)。指定特定的video_bitrate時,此選項將強制one_pass編碼。
我們強烈建議不要強制使用one_pass編碼。兩遍編碼的第一遍比第二遍快,因此從兩遍編碼到單遍編碼只會導致25%的編碼加速,而不會加快50%的編碼。並且兩次通過編碼看起來明顯優於一次通過編碼。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"one_pass": true
}
]
}
audio_constant_bitrate
audio_constant_bitrate:Boolean
API 版本:V2
上級:outputs
默認:false
有效值:true
要么false
兼容的工作類型:VOD
例:true
描述:
盡可能啟用音頻的恆定比特率(CBR)模式。audio_sample_rate可能會進行兼容性調整。
audio_bitrate使用此選項時也必須指定設置。
與AAC和MP3兼容音頻編解碼器。與VP6配合使用時不兼容video_codec
)對於MP3音頻,只有某些比特率與此選項兼容:8、16、24、32、40、48、56、64、80、96、112、128、160、192、224、256、320。
注意:AAC編解碼器沒有定義固定的CBR模式,因此在短時間內比特率仍會有很小的變化。大多數軟件仍會將這些編碼報告為VBR。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_constant_bitrate": true
}
]
}
也可以看看:audio_bitrate