quality
quality:Integer
API-Versionen: V2
Elternteil: outputs
Standard: 3
Gültige Werte: 1-5
Kompatible Auftragstypen: VOD
Beispiel: 4
Beschreibung:
Die gewünschte Ausgabevideoqualität von 1 bis 5. Wählt automatisch ein video_bitrate aus, um diese Qualität zu erreichen.
Dadurch wird automatisch eine Videobitrate ausgewählt, die ein Video mit der gewünschten Qualität erzeugt. Dies ist nützlich, da ein Video aufgrund der Komplexität des Inhalts, der Auflösung usw. möglicherweise eine höhere Bitrate als ein anderes benötigt, um eine visuelle Zielqualität zu erzielen.
Höhere Qualität bedeutet höhere Bitrate und umgekehrt.
Qualität 1: Stark komprimiert. Mittelmäßige visuelle Qualität, aber kleine Dateien.
Qualität 2: Akzeptable Qualität.
Qualität 3: Gute Qualität. Besser als die meisten Webvideos.
Qualität 4: Großartige Qualität. Sieht ausgezeichnet aus.
Qualität 5: Nahezu verlustfrei. Große Dateien. Nicht empfohlen, es sei denn, Sie planen, diese Ausgabe erneut zu codieren.
Als Faustregel gilt, dass durch Verringern der Qualität um eine Stufe die Dateigröße um etwa 40% reduziert wird. Die Codierung mit höherer Qualität ist auch etwas langsamer als die Codierung mit niedrigerer Qualität.
Beachten Sie, dass die Ausgabe-Bitrate bei Verwendung der Qualitätseinstellung je nach Videotyp von Datei zu Datei unterschiedlich ist. Selbst bei gleicher Qualitätseinstellung führt ein Video mit geringer Komplexität (wie ein Screencast) im Allgemeinen zu niedrigeren Bitraten als ein Video mit hoher Komplexität (wie ein Film).
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"quality": 4
}
]
}
Siehe auch: video_bitrate
video_bitrate
video_bitrate:Integer
API-Versionen: V2
Elternteil: outputs
Gültige Werte: Eine positive ganze Zahl. 100000 max.
Kompatible Auftragstypen: VOD
Beispiel: 1200
Beschreibung:
Die gewünschte Ausgangsbitrate für ein Video, ausgedrückt in kbps. Dies führt zu einer vorhersehbaren Ausgabe-Bitrate, jedoch nicht zu vorhersehbarer Qualität. Bei 640 x 480 könnten beispielsweise 500 kbps ausreichen, damit ein Videoblog gut aussieht, aber ein Actionfilm kann bei derselben Bitrate schlecht aussehen. Ebenso kann es für einen Screencast zu hoch sein, was zu einer Datei führt, die größer ist als sie sein muss.
Wenn eine zuverlässige Bitrate wichtiger ist als eine zuverlässige Qualität, wählen Sie video_bitrate. Wenn eine zuverlässige visuelle Qualität wichtiger ist, verwenden Sie quality stattdessen.
video_bitrate verwendet eine VBR-Codierung (Variable Bit Rate) mit zwei Durchgängen. Die one_pass-Codierung kann über das ausgelöst werden one_pass Option, obwohl die one_pass VBR-Codierung normalerweise von schlechter Qualität ist und nur zu einer geringen Beschleunigung führt, wird dies nicht empfohlen.
Denken Sie auch daran, dass zu hohe oder zu niedrige Bitraten unbrauchbar sind. Wenn Sie eine zu niedrige Bitrate angeben, wird standardmäßig automatisch eine akzeptable Bitrate korrigiert. Aktivieren strict Modus, wenn Sie möchten, dass ein Job in dieser Situation fehlschlägt, anstatt automatisch zu korrigieren.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"video_bitrate": 1200
}
]
}
Siehe auch: quality
audio_quality
audio_quality:Integer
API-Versionen: V2
Elternteil: outputs
Standard: 3
Gültige Werte: 1-5
Kompatible Auftragstypen: VOD
Beispiel: 4
Beschreibung:
Die gewünschte Audioausgabequalität von 1 bis 5. Wählt automatisch eine aus audio_bitrate um diese Qualität zu erreichen.
Qualität 1 verwendet eine niedrige Audio-Bitrate, was zu einer geringen Klangqualität, aber kleinen Dateien führt. Qualität 5 führt zu einer hohen Audio-Bitrate für größere Dateien, aber höherer Qualität.
Wir empfehlen, für die meisten Zwecke 3 oder 4-5 zu verwenden, wenn eine transparente Klangqualität gewünscht wird.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_quality": 4
}
]
}
Siehe auch: quality und audio_bitrate
audio_bitrate
audio_bitrate:Integer
API-Versionen: V2
Elternteil: outputs
Gültige Werte: Eine positive ganze Zahl.
Kompatible Auftragstypen: VOD
Beispiel: 96
Beschreibung:
Eine Einstellung der Ausgangsbitrate in Kbit / s. Bei einem 2-Kanal-Ausgang ist dies die gesamte Audio-Bitrate und nicht die Bitrate jedes Kanals. Daher wird der 128-kbit / s-Stereoausgang mit 64 kbit / s pro Kanal codiert. Unterhalb von 48 kbit / s pro Kanal kann die Qualität darunter leiden.
Beachten Sie dies, wenn Sie eine manuell einstellen audio_sample_rate müssen Sie ein kompatibles audio_bitrate auswählen, da sonst die Codierung fehlschlägt. Standardmäßig korrigieren wir diese Fehler automatisch und wählen eine gültige Kombination aus Bitrate und Abtastrate. Aktivieren Sie strict_mode, um diese automatische Korrektur zu vermeiden.
Diese Einstellung begrenzt nicht die Spitzenbitrate des codierten Videos. Wenn das System feststellt, dass die endgültige codierte Bitrate höher als dieser Wert ist, startet es die Codierung intern mit dieser Bitrate als durchschnittlicher Zielbitrate neu. Sehen decoder_bitrate_cap zur Begrenzung der Spitzenbitraten.
Bei AAC-Audio wird eine Bitrate von weniger als 84 eingestellt AAC-Profil zu HE-AAC.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_bitrate": 96
}
]
}
Siehe auch: Audio Qualität , audio_sample_rate , und max_aac_profile
max_video_bitrate
max_video_bitrate:Integer
API-Versionen: V2
Elternteil: outputs
Gültige Werte: Eine positive ganze Zahl. 100000 max.
Kompatible Auftragstypen: VOD
Beispiel: 1500
Beschreibung:
Eine maximale durchschnittliche Bitrate für einen Film. Überschreibt sowohl die Qualitäts- als auch die video_bitrate-Einstellungen, um sicherzustellen, dass eine Bitrate die angegebene Zahl nicht überschreitet.
max_video_bitrate ist besonders nützlich beim Codieren für mobile Geräte mit dem quality Einstellung, die automatisch eine Bitrate auswählt. Mobile Geräte haben manchmal feste Bitratenlimits; Das iPhone 3GS hat beispielsweise eine Bitratenbegrenzung von 1500 kbps.
Hinweis: Diese Option ist nicht mit VP6- oder HEVC-Codecs kompatibel.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"max_video_bitrate": 1500
}
]
}
speed
speed:Integer
API-Versionen: V2
Elternteil: outputs
Standard: 3
Gültige Werte: 1-5
Kompatible Auftragstypen: vod
Beispiel: 4
Beschreibung:
Eine Zieltranscodierungsgeschwindigkeit. Eine langsamere Transcodierung ermöglicht eine erweiterte Dateikomprimierung, während eine schnellere Transcodierung möglich ist, indem einige erweiterte Komprimierungsfunktionen übersprungen werden. Gültige Werte sind 1-5.
Hinweis: Derzeit verfügt nur der H.264-Ausgang über fünf Geschwindigkeitsstufen. Für VP6-Inhalte sind 1-2 ein langsamerer Modus und 3-5 ein schnellerer Modus. Andere Video-Codecs unterstützen diese Einstellung überhaupt nicht.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"speed": 4
}
]
}
decoder_bitrate_cap
decoder_bitrate_cap:Integer
API-Versionen: V2
Elternteil: outputs
Gültige Werte: Eine positive ganze Zahl. 100000 max.
Kompatible Auftragstypen: VOD
Beispiel: 800
Beschreibung:
Die maximale Bitrate wird dem Decoder über einen Puffer zugeführt. Diese Einstellung wird normalerweise nur für Streaming (RTMP, HLS oder Broadcast-Video) verwendet.
Verwenden Sie diese Einstellung nur, wenn Sie ihre Auswirkungen verstehen, da sie die Videoqualität beeinträchtigen kann.
Bei Live-Ausgaben ist dieser Standardwert 15% höher als der video_bitrate , wenn video_bitrate angegeben ist.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_bitrate_cap": 800
}
]
}
Siehe auch: decoder_buffer_size
decoder_buffer_size
decoder_buffer_size:Integer
API-Versionen: V2
Elternteil: outputs
Gültige Werte: Eine positive ganze Zahl. 100000 max.
Kompatible Auftragstypen: VOD
Beispiel: 800
Beschreibung:
Die Größe des Puffers, der dem Decoder zugeführt wird, wenn eine bitrate_cap verwendet wird, ausgedrückt in kbps. Die buffer_size geteilt durch bitrate_cap repräsentiert die Größe des Puffers in Sekunden; Wenn Sie also bitrate_cap auf 1000 und buffer_size auf 1000 setzen, beträgt der Puffer effektiv 1,0 Sekunden. Wenn bitrate_cap 500 und buffer_size 1000 beträgt, beträgt der Puffer 2,0 Sekunden.
Verwenden Sie diese Einstellung nur, wenn Sie ihre Auswirkungen verstehen, da sie die Videoqualität beeinträchtigen kann. Dies sollte normalerweise nur zum Streamen (oder zur Gerätewiedergabe) verwendet werden.
Bei Live-Ausgaben beträgt der Standardwert 300% der decoder_bitrate_cap, wodurch eine Pufferdauer von 3 Sekunden erstellt wird. Wenn jedoch auch segment_seconds festgelegt ist, wird die Standardgröße decoder_buffer_size so reduziert, dass die effektive Pufferdauer die Hälfte der Dauer eines Segments beträgt.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"decoder_buffer_size": 800
}
]
}
Siehe auch: decoder_bitrate_cap
one_pass
one_pass:Boolean
API-Versionen: V2
Elternteil: outputs
Standard: false
Gültige Werte: true oder false
Kompatible Auftragstypen: vod
Beispiel: true
Beschreibung:
Standardmäßig verwenden wir die Zwei-Pass-Codierung, wenn Sie ein Ziel codieren video_bitrate und one_pass-Codierung bei Ausführung einer Konstanten quality Codierung (die nicht von einem zweiten Durchgang profitiert). Diese Option erzwingt die one_pass-Codierung, wenn auf ein bestimmtes video_bitrate abgezielt wird.
Wir empfehlen dringend, die one_pass-Codierung nicht zu erzwingen. Der erste Durchgang bei der Zwei-Durchlauf-Codierung ist schneller als der zweite Durchgang. Wenn Sie also von der Zwei-Durchlauf-Codierung zur One-Pass-Codierung wechseln, wird die Codierung nur um 25% beschleunigt, nicht um 50%. Die Zwei-Pass-Codierung sieht deutlich besser aus als die One-Pass-Codierung.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"one_pass": true
}
]
}
audio_constant_bitrate
audio_constant_bitrate:Boolean
API-Versionen: V2
Elternteil: outputs
Standard: false
Gültige Werte: true oder false
Kompatible Auftragstypen: VOD
Beispiel: true
Beschreibung:
Aktivieren Sie nach Möglichkeit den CBR-Modus (Constant Bitrate) für Audio. audio_sample_rate kann aus Kompatibilitätsgründen angepasst werden.
audio_bitrate Bei Verwendung dieser Option muss auch die Einstellung angegeben werden.
Kompatibel mit AAC und MP3 Audio-Codecs. Nicht kompatibel mit dem VP6 video_codec.) Bei MP3-Audio sind nur bestimmte Bitraten mit dieser Option kompatibel: 8, 16, 24, 32, 40, 48, 56, 64, 80, 96, 112, 128, 160, 192, 224, 256, 320.
Hinweis: Der AAC-Codec definiert keinen festen CBR-Modus, daher gibt es über kurze Zeiträume immer noch kleine Abweichungen in der Bitrate. Die meisten Programme melden diese Codierungen weiterhin als VBR.
{
"input": "s3://zencodertesting/test.mov",
"outputs": [
{
"audio_constant_bitrate": true
}
]
}
Siehe auch: audio_bitrate