Configuración CAE

Resumen

La codificación sensible al contexto crea múltiples interpretaciones de su video de origen según las pautas que proporcione, pero también según las características del video en sí. Esto ayuda a evitar el costo de transcodificar y almacenar sus videos mediante la creación de representaciones que serán esencialmente inútiles, dadas las características de la fuente.

Ver el Guía CAE para obtener información adicional y recomendaciones sobre la configuración.

video_codecs

video_codecs:Array

Versiones de API: V2

Padre: dynamic_profile_options

Valores de elementos de matriz válidos: h264, hevc

Valor por defecto: ninguno

Tipos de trabajo compatibles: VOD

Ejemplo: ["h264", "hevc"]

Descripción:

Para salidas de códecs mixtos, una matriz de códecs para crear representaciones. Actualmente, los valores de elementos permitidos son h264 y hevc.

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

video_codec_options

video_codecs:Object

Versiones de API: V2

Padre: dynamic_profile_options

Valor por defecto: ninguno

Tipos de trabajo compatibles: VOD

Ejemplo:

"video_codec_options": {
  "h264": {
    "min_renditions": 2,
    "max_resolution": { "width": 1280, "height": 720 }
  },
  "hevc": {
    "min_renditions": 2,
    "max_resolution": { "width": 1920, "height": 1080 }
  }
}

Descripción:

Para salidas de códec mixto, un objeto que especifica las opciones para cada códec. Cada propiedad es un objeto con el nombre h264 o hevc, sus propiedades son el conjunto de restricciones para las copias de ese códec. Las propiedades permitidas para estos objetos son:

min_renditions requerido
min_bitrate
max_bitrate
max_first_rendition_bitrate
min_resolution
max_resolution
max_first_rendition_resolution

{
    "dynamic_profile_options": {
      "max_renditions": 6,
      "video_codecs" : ["h264", "hevc"'],
      "video_codec_options": {
        "h264": {
          "min_renditions": 2,
          "max_resolution": { "width": 1280, "height": 720 }
        },
        "hevc": {
          "min_renditions": 2,
          "max_resolution": { "width": 1920, "height": 1080 }
        }
      }
    }
  }

min_renditions

min_renditions:Integer

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1-15

Valor por defecto: 1

Tipos de trabajo compatibles: VOD

Ejemplo: 3

Descripción:

El número mínimo de representaciones para generar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2
          }
        }

max_renditions

max_renditions:Integer

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1-15

Valor por defecto: 8

Tipos de trabajo compatibles: VOD

Ejemplo: 10

Descripción:

El número máximo de representaciones para generar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10
          }
        }

min_resolution

min_resolution:Object

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 16x16 - 8192x8192

Valor por defecto: 192x108

Tipos de trabajo compatibles: VOD

Ejemplo: vea abajo

Descripción:

Resolución mínima a considerar para la escalera.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            }
          }
        }

max_resolution

max_resolution:Object

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 16x16 - 8192x8192

Valor por defecto: resolución de fuente

Tipos de trabajo compatibles: VOD

Ejemplo: vea abajo

Descripción:

Resolución máxima a considerar para la escalera.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_resolution": {
              "height": 180,
              "width": 320
            },
            "max_resolution": {
              "height": 1080,
              "width": 1920
            }
          }
        }

max_frame_rate

max_frame_rate:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 0,1 - 120

Valor por defecto: 30

Tipos de trabajo compatibles: VOD

Ejemplo: 60

Descripción:

Velocidad de fotogramas máxima que se puede utilizar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "max_frame_rate": 60
          }
        }

keyframe_rate

keyframe_rate:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 0,5, 1,0

Valor por defecto: 0.5

Tipos de trabajo compatibles: VOD

Ejemplo: 0.5

Descripción:

Tasa de fotogramas clave. Este valor puede ser 0,5 o 1. Para el contenido habilitado para SSAI, este valor debe ser 1.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "keyframe_rate": 0.5
          }
        }

fixed_frame_rate

fixed_frame_rate:Boolean

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: verdadero o falso

Valor por defecto: cierto

Tipos de trabajo compatibles: VOD

Ejemplo: cierto

Descripción:

Indica al generador que utilice la misma velocidad de fotogramas en todas las representaciones. Si es falso, a las representaciones del perfil de línea base H.264 a resoluciones inferiores a 360p se les asignará una velocidad de fotogramas reducida a la mitad.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "fixed_frame_rate": true
          }
        }

min_bitrate

min_bitrate:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 40 - 400

Valor por defecto: 200

Tipos de trabajo compatibles: VOD

Ejemplo: 300

Descripción:

Tasa de bits mínima [kbps] que se puede utilizar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300
          }
        }

max_bitrate

max_bitrate:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 400 - 40000

Valor por defecto: 15000

Tipos de trabajo compatibles: VOD

Ejemplo: 20000

Descripción:

Velocidad de bits máxima [kbps] que se puede utilizar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
          }
        }

max_first_rendition_bitrate

max_first_rendition_bitrate:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 40 - 1000

Valor por defecto: 400

Tipos de trabajo compatibles: VOD

Ejemplo: 700

Descripción:

Velocidad de bits máxima [kbps] que se puede utilizar para la primera reproducción.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_bitrate": 300,
            "max_bitrate": 20000
            "max_first_rendition_bitrate": 700
          }
        }

min_granularity

min_granularity:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1 - 100 (%)

Valor por defecto: 30 (%)

Tipos de trabajo compatibles: VOD

Ejemplo: 20

Descripción:

Cambio relativo mínimo en la tasa de bits entre interpretaciones.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20
          }
        }

max_granularity

max_granularity:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1 - 100 (%)

Valor por defecto: 90 (%)

Tipos de trabajo compatibles: VOD

Ejemplo: 80

Descripción:

Cambio relativo máximo en la tasa de bits entre interpretaciones.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "min_granularity": 20,
            "max_granularity": 80
          }
        }

video_codec

video_codec:String

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: h264, hevc

Valor por defecto: h264

Tipos de trabajo compatibles: VOD

Ejemplo: h264

Descripción:

Códec de video a utilizar.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_codec": "h264"
          }
        }

bitrate_cap_to_bitrate_ratio

bitrate_cap_to_bitrate_ratio:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1,0 - 2,0

Valor por defecto: 1.3

Tipos de trabajo compatibles: VOD

Ejemplo: 1.5

Descripción:

Relación entre la tasa de bits máxima y la tasa de bits promedio que se utilizará para la codificación VBR.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5
          }
        }

buffer_size_to_bitrate_ratio

buffer_size_to_bitrate_ratio:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: 1,0 - 4,0

Valor por defecto: 2.0

Tipos de trabajo compatibles: VOD

Ejemplo: 2.5

Descripción:

Relación entre el tamaño del búfer del decodificador y la tasa de bits promedio que se utilizará para la codificación VBR.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5
          }
        }

bitrate_cap_offset

bitrate_cap_offset:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valor por defecto: 64 [KBPS]

Tipos de trabajo compatibles: VOD

Ejemplo: 128

Descripción:

Constante agregada al calcular la tasa de bits máxima.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            "bitrate_cap_offset": 128
          }
        }

buffer_size_offset

buffer_size_offset:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valor por defecto: 85 [KBPS]

Tipos de trabajo compatibles: VOD

Ejemplo: 100

Descripción:

Constante agregada al calcular el tamaño del búfer VBV.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "bitrate_cap_to_bitrate_ratio": 1.5,
            "buffer_size_to_bitrate_ratio": 2.5,
            bitrate_cap_offset": 128,
            "buffer_size_offset": 100
          }
        }

quality_rate_tune

quality_rate_tune:Number

Versiones de API: V2

Padre: dynamic_profile_options

Valores válidos: -40,0 - 40,0

Valor por defecto: 0

Tipos de trabajo compatibles: VOD

Ejemplo: 2

Descripción:

Configurando quality_rate_tune a un número positivo de 1 a 40, los perfiles CAE tendrán una calidad de video más alta a costa de tasas de bits más altas. De manera similar, dado un número en el rango de -1 a -40, se pueden reducir las tasas de bits, a costa de disminuir la calidad del video.

Por ejemplo, con -10 se puede esperar una tasa de bits aproximadamente un 10% menor. Con 10, la tasa de bits aumentará en general alrededor del 10%. Estos números son aproximaciones, ya que CAE para valores positivos de quality_rate_tune toma precauciones adicionales para garantizar una calidad de video muy alta y puede haber otros parámetros que limiten la velocidad de bits, como la granularidad y el número de representaciones.

Dado que el contenido típico y la calidad de video deseada frente al ancho de banda varían mucho, puede ser aconsejable experimentar con valores diferentes.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "quality_rate_tune": 2
          }
        }

select_baseline_profile_configuration

select_baseline_profile_configuration:Boolean

Versiones de API: V2

Padre: dynamic_profile_options

Valor por defecto: cierto

Tipos de trabajo compatibles: VOD

Ejemplo: falso

Descripción:

Al menos una reproducción utilizada en el perfil será el perfil de línea de base. Tenga en cuenta que select_baseline_profile_configuration es true por defecto, y requiere al menos una interpretación para tener una resolución igual o inferior a 512x288.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_baseline_profile_configuration": true
          }
        }

select_distinct_configurations

select_distinct_configurations:Boolean

Versiones de API: V2

Padre: dynamic_profile_options

Valor por defecto: falso

Tipos de trabajo compatibles: VOD

Ejemplo: cierto

Descripción:

Si es verdadero, CAE se asegurará de que no haya dos representaciones que utilicen la misma combinación de resolución, velocidad de fotogramas y perfil de códec.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "select_distinct_configurations": true
          }
        }

video_configurations

video_configurations:Array

Versiones de API: V2

Padre: dynamic_profile_options

Defecto: El generador de perfiles utiliza listas de resoluciones estándar para todas las relaciones de aspecto conocidas. Siempre que sea posible, la relación de aspecto, la relación de aspecto de la muestra y la velocidad de fotogramas de la fuente se conservan en las configuraciones de salida.

Tipos de trabajo compatibles: VOD

Ejemplo: vea abajo

Descripción:

Un conjunto de estructuras que describen resoluciones, velocidades de fotogramas y configuraciones de códec asociadas que deben generarse de manera preferente o obligatoria como parte de la codificación CAE. Ver el sección debajo.

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options": {
            "min_renditions": 2,
            "max_renditions": 10,
            "video_configurations": [
              {
                "width": 1920,
                "height": 1080,
                "sample_aspect_ratio": "16:9",
                "frame_rate": 30,
                "video_codec_profile": "high",
                "video_codec_level": 4.1,
                "video_reference_frames": 4,
                "video_bframes": 3,
                "required": true
              }
              ]
          }
        }

watermarks

watermarks:Array

Versiones de API: V2

Padre: dynamic_profile_options

Defecto: El generador de perfiles utiliza listas de resoluciones estándar para todas las relaciones de aspecto conocidas. Siempre que sea posible, la relación de aspecto, la relación de aspecto de la muestra y la velocidad de fotogramas de la fuente se conservan en las configuraciones de salida.

Tipos de trabajo compatibles: VOD

Ejemplo: vea abajo

Descripción:

Una serie de hashes que describen filigranas.

    {
        "input": "s3://zencodertesting/test.mov",
        "generate_dynamic_profile": true,
        "dynamic_profile_options" : {
          "min_rendition": 2,
          "max_rendition": 6,
          "watermarks":[
           {
              "url": "{url_to_watermark}",
             "width": "10%",
             "height": "10%"
           }
          ]
        }
      }

Las marcas de agua también pueden formar parte de video_configurations:

        {
          "input": "s3://zencodertesting/test.mov",
          "generate_dynamic_profile": true,
          "dynamic_profile_options" : {
            "video_configurations": [
              {
               "width": 640,
               "height": 360,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-10",
                    "y": 10"
                  }
                ]
              },
              {
               "width": 960,
               "height": 540,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-15",
                    "y": "15"
                 }
                ]
              },
              {
                "width": 1280,
                "height": 720,
                "watermarks":[
                  {
                    "url": "{url_to_watermark}",
                    "x": "-20",
                    "y": "20"
                 }
                ]
              }
            ]
          }

Additional settings

A continuación, se muestran configuraciones de codificación generales adicionales que se pueden usar para CAE.

Ajustes adicionales
Nombre	Tipo	Descripción	Predeterminado
`deblock`	booleano	Aplica un filtro de desbloqueo al video.	`false`
`deinterlace`	cuerda	Determina si se aplica o no un filtro de desentrelazado. El valor predeterminado es "detectar": si el archivo de entrada se detecta como entrelazado, se desentrelazará. Ajústelo en "on" para forzar el desentrelazado (que reducirá la calidad si la entrada no está entrelazada), o en "off" para evitar el desentrelazado.	`detect`
`deinterlace_mode`	cuerda	Si no se incluye o se establece en `frame-to-frame` , las salidas de Zencoder coincidirán con la velocidad de fotogramas del archivo de entrada. Si se establece en `field-to-frame` , Zencoder duplicará la velocidad de fotogramas del archivo de entrada para la salida. Si configura manualmente `framerate` para duplicar la velocidad de fotogramas del archivo de entrada, Zencoder configurará automáticamente `deinterlace_mode` a `field-to-frame` y duplicar la velocidad de fotogramas para la salida.	`frame-to-frame`
`denoise`	cuerda	Aplica un filtro de eliminación de ruido al video. Las opciones válidas son `weak` , `medium` , `strong` , y `strongest`. Por lo general, reduce el tamaño del archivo entre un 5% y un 20%, según el nivel de eliminación de ruido, la tasa de bits y el video de origen. Cualquier eliminación de ruido ralentiza la codificación en aproximadamente un 20%. Los valores por encima de 'débil' deben usarse con cuidado, aunque la animación a veces puede manejar un alto nivel de eliminación de ruido.	`none (denoising not applied)`
`speed`	Entero	Ajuste de la velocidad de codificación.	`3`
`one_pass`	booleano	Forzar la codificación de 1 paso.	`false`
`start_clip`	Cadena / Número	Cree un clip del video original, comenzando en un momento en particular. Puede ser un código de tiempo con un formato de `HH:MM:SS.S` o un decimal que expresa el número de segundos en el que se va a empezar.	`0`
`clip_length`	Cadena / Número	Crea un clip de una duración determinada. Puede ser una duración con un formato de `HH:MM:SS.S` o un decimal que expresa la duración del clip en segundos.	duración de la fuente

Configuración de HDR

CAE también es compatible con HDR10 y las siguientes configuraciones se pueden incluir en dynamic_profile_options.

Ajustes adicionales
Nombre	Tipo	Descripción	Predeterminado
`master_display`	Objeto	Hash que contiene ajustes de luminancia y volumen de color para salidas HDR.	ninguno
`max_content_light_level`	Entero	Nivel de luz máximo para el contenido como liendres o candelas enteras por metro cuadrado (cd/m2) - valores enteros.	ninguno
`max_frame_average_light_level`	Entero	Nivel de luz medio máximo para los marcos de contenido liendres o candelas por metro cuadrado (cd/m2) - valores enteros. Aunque se permiten valores de hasta 10000, los valores en el rango de 100-200 generalmente producirán los mejores resultados.	ninguno

Ajustes de configuraciones de video

Es posible que desee utilizar esta función si CAE no está produciendo configuraciones específicas que debe tener en sus salidas.

Se trata de un conjunto de objetos que describen las resoluciones de vídeo y la configuración del códec que CAE debería / debe producir como parte de su salida (consulte la ejemplo de arriba). Esta matriz es Opcional. Si se omite, se utilizará una serie de resoluciones predeterminadas, que van desde 192x108 hasta la resolución de contenido, como el conjunto de entrada predeterminado para CAE.

Ajustes de configuración de video
Nombre	Tipo	Descripción	¿Requerido?
`width`	Entero	Ancho del cuadro de video [píxeles]	requerido
`height`	Entero	Altura del cuadro de video [píxeles]	requerido
`sample_aspect_ratio`	Entero: par de enteros	Proporción de aspecto de muestra (p. Ej., 1: 1, 4: 3)	opcional
`frame_rate`	Número	Velocidad de fotogramas de video [fps]	opcional
`video_codec_profile`	cuerda	perfil de códec de video	opcional
`video_codec_level`	cuerda	nivel de códec de video	opcional
`video_reference_frames`	Entero	Restricción en el número de marcos de referencia. Predeterminado = 4 (3 para la línea base H.264).	opcional
`video_bframes`	Entero	Restricción en el número de fotogramas B. Predeterminado = 3 (0 para la línea base H.264).	opcional
`required`	booleano	Establecer esto en true garantizará los ajustes de configuración sugeridos en la salida. Predeterminado = falso.	opcional