品質
quality:Integer
API バージョン:V1、V2
親:出力
デフォルト：3
有効な値:1-5
互換性のあるジョブタイプ:すべて
例:4
説明:
望ましい出力ビデオ品質（1～5）。この品質を達成するために video_bitrate を自動的に選択します。
これにより、必要な品質のビデオを生成するビデオビットレートが自動的に選択されます。コンテンツや解像度などが複雑なため、目標の視覚品質を達成するために、あるビデオが別のビデオよりも高いビットレートを必要とする場合があるため、これは便利です。
品質が高いほどビットレートが高くなり、その逆も同様です。
品質1:高度に圧縮。平凡な視覚的品質ですが、ファイルは小さいです。
品質2：許容できる品質。
品質3：良い品質。ほとんどのWebビデオよりも優れています。
品質4：素晴らしい品質。見栄えがします。
品質5：ほぼ可逆だな大きなファイル。この出力を再度エンコードする予定がない限り、推奨されません。
経験則として、品質のレベルを下げると、ファイルサイズが約 40% 減少します。高品質のエンコーディングは、低品質のエンコーディングよりも少し遅くなります。
画質設定を使用すると、ビデオの種類に応じて、出力ビットレートはファイルごとに異なることに注意してください。同じ [品質] 設定でも、スクリーンキャストのような複雑さの低いビデオは、通常、高複雑度のビデオ（ムービーなど）よりもビットレートが低くなります。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"quality": 4
}
]
}
bitrate
video_bitrate:Integer
API バージョン:V1、V2
親:出力
有効な値：正の整数。100000マックス
互換性のあるジョブタイプ:すべて
例:1200
説明:
ビデオに必要な出力ビットレート（kbps 単位）。これにより、出力ビットレートは予測可能になりますが、品質は予測できません。たとえば、640 x 480 では、動画ブログの見栄えが良くなるには 500 kbps で十分ですが、アクションムービーは同じビットレートで悪くなる可能性があります。同様に、スクリーンキャストには高すぎるため、ファイルは必要以上に大きくなります。
信頼できるビットレートが信頼できる品質よりも重要な場合は、video_bitrateを選択してください。信頼性の高い視覚品質がより重要な場合は、代わりに品質を使用してください。
video_bitrateは、2パスの可変ビットレート（VBR）エンコーディングを使用します。 one_passエンコーディングは、 one_passただし、one_pass VBRエンコーディングは通常品質が低く、速度がわずかに向上するだけなので、これはお勧めしません。
また、高すぎるまたは低すぎるビットレートは使用できないことにも注意してください。デフォルトでは、低すぎるビットレートを指定すると、許容可能なビットレートに自動的に修正されます。この状況でジョブを自動修正ではなく失敗させたい場合は、厳密モードを有効にします。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"video_bitrate": 1200
}
]
}
参照:品質
オーディオ品質
audio_quality:Integer
API バージョン:V1、V2
親:出力
デフォルト：3
有効な値:1-5
互換性のあるジョブタイプ:すべて
例:4
説明:
1から5までの望ましい出力オーディオ品質。自動的に選択しますaudio_bitrateこの品質を達成するために。
品質1は低いオーディオビットレートを使用するため、音質は低くなりますが、ファイルは小さくなります。品質 5 は、大きなファイルでは高いオーディオビットレートになりますが、品質は向上します。
ほとんどの用途には3、透明な音質が必要な場合は4-5を使用することをお勧めします。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_quality": 4
}
]
}
参照:品質と audio_bitrate
audio_bitrate
audio_bitrate:Integer
API バージョン:V1、V2
親:出力
有効な値：正の整数。
互換性のあるジョブタイプ:すべて
例:96
説明:
出力ビットレート設定（Kbps 単位）。2 チャンネル出力では、各チャンネルのビットレートではなく、オーディオの総ビットレートになります。したがって、128kbps ステレオ出力は、チャンネルあたり 64 kbps でエンコードされます。チャネルあたり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
}
]
}
video_bitrate
max_video_bitrate:Integer
API バージョン:V1、V2
親:出力
有効な値：正の整数。100000マックス
互換性のあるジョブタイプ:すべて
例:1500
説明:
ムービーの最大平均ビットレート。品質と video_bitrate の両方の設定をオーバーライドして、ビットレートが指定された数を超えないようにします。
max_video_bitrate は、ビットレートを自動選択する品質設定を使用してモバイルデバイスでエンコードする場合に特に便利です。モバイルデバイスには、固定ビットレート制限があります。たとえば、iPhone 3GSのビットレート制限は 1500 kbps です。
注:このオプションは、VP6 または HEVC コーデックと互換性がありません。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"max_video_bitrate": 1500
}
]
}
速度
speed:Integer
API バージョン:V1、V2
親:出力
デフォルト：3
有効な値:1-5
互換性のあるジョブの種類: vod
例:4
説明:
ターゲットトランスコーディング速度。トランスコーディングが遅くなると、より高度なファイル圧縮が可能になり、高度な圧縮機能をスキップすることで、より高速なトランスコーディングが可能です。有効な値は 1 ～ 5 です。
注:現時点では、H.264 出力のみ 5 つの速度レベルがあります。VP6コンテンツの場合、1-2は低速モードであり、3-5は高速モードです。他のビデオコーデックでは、この設定はまったくサポートされていません。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"speed": 4
}
]
}
decoder_bitrate_cap
decoder_bitrate_cap:Integer
API バージョン:V1、V2
親:出力
有効な値：正の整数。100000マックス
互換性のあるジョブタイプ:すべて
例:800
説明:
バッファを介してデコーダに送られる最大ビットレート。この設定は通常、ストリーミング（RTMP、HLS、またはブロードキャストビデオ）にのみ使用されます。
この設定は、ビデオの品質が低下する可能性があるため、その意味を理解している場合にのみ使用してください。
ライブ出力の場合、 video_bitrate が指定されている場合、これはデフォルトで video_bitrate よりも 15% 高くなります。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_bitrate_cap": 800
}
]
}
decoder_buffer_size
decoder_buffer_size:Integer
API バージョン:V1、V2
親:出力
有効な値：正の整数。100000マックス
互換性のあるジョブタイプ:すべて
例:800
説明:
bitrate_cap を使用するときにデコーダに供給されるバッファのサイズ。kbps で表されます。buffer_size を bitrate_cap で割った値は、バッファのサイズを秒単位で表します。したがって、bitrate_cap を 1000 に、buffer_size を 1000 に設定すると、バッファは実質的に 1.0 秒になります。ビットキャップが 500、バッファサイズが 1000 の場合、バッファは 2.0 秒です。
この設定は、ビデオの品質が低下する可能性があるため、その意味を理解している場合にのみ使用してください。これは通常、ストリーミング（またはデバイスの再生）にのみ使用する必要があります。
ライブ出力の場合、これはデフォルトでdecoder_bitrate_capの300％になり、3秒のバッファー期間が作成されます。ただし、segment_secondsも設定されている場合、デフォルトのdecoder_buffer_sizeは、有効なバッファー期間がセグメントの期間の半分になるように縮小されます。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_buffer_size": 800
}
]
}
one_pass
one_pass:Boolean
API バージョン:V1、V2
親:出力
デフォルト:false
有効な値:trueまたはfalse
互換性のあるジョブの種類: vod
例:true
説明:
デフォルトでは、ターゲットの video_bitrate にエンコードするたびに 2 パスエンコーディングを使用し、一定品質エンコーディングを実行する場合は one_passエンコーディングを使用します（2 回目のパスのメリットはありません）。このオプションは、特定のvideo_bitrateをターゲットにするときにone_passエンコーディングを強制します。
one_pass エンコーディングを強制しないことを強くお勧めします。2 パスエンコーディングの最初のパスは 2 番目のパスよりも高速です。したがって、2 パスエンコーディングから one_pass エンコーディングに進むと、エンコードが 50% 高速ではなく、25% のエンコーディングのスピードアップになります。また、2パスエンコーディングは、one_pass エンコーディングよりも大幅に優れています。
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"one_pass": true
}
]
}
audio_constant_bitrate
audio_constant_bitrate:Boolean
API バージョン:V1、V2
親:出力
デフォルト:false
有効な値:trueまたはfalse
互換性のあるジョブタイプ:すべて
例: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
}
]
}