Paramètres CAE

Aperçu

Context Aware Encoding crée plusieurs formats associés de votre vidéo source en fonction des directives que vous fournissez, mais également en fonction des caractéristiques de la vidéo elle-même. Cela permet d'éviter les coûts de transcodage et de stockage de vos vidéos en créant des rendus qui seront essentiellement sans valeur, compte tenu des caractéristiques de la source.

Voir le Guide CAE pour plus d'informations et des recommandations sur les paramètres.

video_codecs

video_codecs:Array

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs d'éléments de tableau valides : h264, hevc

Valeur par défaut : aucun

Types de tâches compatibles : VOD

Exemple : ["h264", "hevc"]

Description :

Pour les sorties de codecs mixtes, un tableau des codecs pour lesquels créer des rendus. Actuellement, les valeurs d'élément autorisées sont h264 et 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeur par défaut : aucun

Types de tâches compatibles : VOD

Exemple :

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

Description :

Pour les sorties de codec mixtes, un objet spécifiant les options pour chaque codec. Chaque propriété est un objet portant le nom h264 ou hevc, ses propriétés définissent les contraintes pour les rendus de ce codec. Les propriétés autorisées pour ces objets sont :

min_renditions obligatoire
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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1-15

Valeur par défaut : 1

Types de tâches compatibles : VOD

Exemple : 3

Description :

Nombre minimal de formats associés à générer.

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

max_renditions

max_renditions:Integer

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1-15

Valeur par défaut : 8

Types de tâches compatibles : VOD

Exemple : dix

Description :

Nombre maximal de formats associés à générer.

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

min_resolution

min_resolution:Object

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 16x16 - 8192 x 8192

Valeur par défaut : 192x108

Types de tâches compatibles : VOD

Exemple : voir ci-dessous

Description :

Résolution minimale à prendre en considération pour l'échelle.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 16x16 - 8192 x 8192

Valeur par défaut : résolution de la source

Types de tâches compatibles : VOD

Exemple : voir ci-dessous

Description :

Résolution maximale à prendre en considération pour l'échelle.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 0,1 - 120

Valeur par défaut : 30

Types de tâches compatibles : VOD

Exemple : 60

Description :

Fréquence d'images maximale pouvant être utilisée.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 0,5, 1,0

Valeur par défaut : 0,5

Types de tâches compatibles : VOD

Exemple : 0,5

Description :

Taux d'image-clé. Cette valeur peut être 0,5 ou 1. Pour le contenu activé SSAI, cette valeur doit être 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : vrai ou faux

Valeur par défaut : true

Types de tâches compatibles : VOD

Exemple : vrai

Description :

Indique au générateur d'utiliser la même fréquence d'images sur tous les formats associés. Si la valeur est fausse, les formats associés du profil de base H.264 dont les résolutions sont inférieures à 360p se verront attribuer une fréquence d'images réduite de moitié.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 40 - 400

Valeur par défaut : 200

Types de tâches compatibles : VOD

Exemple : 300

Description :

Débit binaire minimum [kbit/s] qui peut être utilisé.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 400 - 40000

Valeur par défaut : 15000

Types de tâches compatibles : VOD

Exemple : 20000

Description :

Débit maximal [kbps] pouvant être utilisé.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 40 à 1000

Valeur par défaut : 400

Types de tâches compatibles : VOD

Exemple : 700

Description :

Débit maximal [kbit/s] pouvant être utilisé pour le premier rendu.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1100 (%)

Valeur par défaut : 30 (%)

Types de tâches compatibles : VOD

Exemple : 20

Description :

Variation relative minimale du débit binaire entre les formats associés.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1100 (%)

Valeur par défaut : 90 (%)

Types de tâches compatibles : VOD

Exemple : 80

Description :

Variation relative maximale du débit binaire entre les formats associés.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : h264, hevc

Valeur par défaut : h264

Types de tâches compatibles : VOD

Exemple : h264

Description :

Codec vidéo à utiliser.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1,0 à 2,0

Valeur par défaut : 1.3

Types de tâches compatibles : VOD

Exemple : 1.5

Description :

Rapport entre le débit binaire maximal et le débit binaire moyen à utiliser pour l'encodage 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : 1,0 à 4,0

Valeur par défaut : 2.0

Types de tâches compatibles : VOD

Exemple : 2.5

Description :

Rapport entre la taille du tampon du décodeur et le débit binaire moyen à utiliser pour le codage 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeur par défaut : 64 [KBPS]

Types de tâches compatibles : VOD

Exemple : 128

Description :

Constante ajoutée lors du calcul du débit binaire maximal.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeur par défaut : 85 [KBPS]

Types de tâches compatibles : VOD

Exemple : 100

Description :

Constante ajoutée lors du calcul de la taille du tampon 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeurs valides : -40,0 - 40,0

Valeur par défaut : 0

Types de tâches compatibles : VOD

Exemple : 2

Description :

En définissant quality_rate_tune à un nombre positif de 1 à 40, les profils CAE auront une qualité vidéo supérieure au prix de débits binaires plus élevés. De même, étant donné un nombre compris entre -1 et -40, on peut réduire les débits binaires, au prix d'une diminution de la qualité vidéo.

Par exemple, avec -10, on peut s'attendre à des débits binaires inférieurs d'environ 10 %. Avec 10, les débits augmenteront en général d'environ 10%. Ces nombres sont des approximations, puisque CAE pour les valeurs positives de quality_rate_tune prend des précautions supplémentaires pour garantir une qualité vidéo très élevée, et il peut y avoir d'autres paramètres qui limitent les débits binaires tels que la granularité et le nombre de rendus.

Étant donné que le contenu typique et la qualité vidéo souhaitée par rapport à la bande passante varient considérablement, il peut être conseillé d'expérimenter différentes valeurs.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeur par défaut : true

Types de tâches compatibles : VOD

Exemple : faux

Description :

Au moins un format associé utilisé dans le profil sera le profil de base. Notez que select_baseline_profile_configuration c'est true par défaut, et il nécessite au moins un format associé pour avoir une résolution égale ou inférieure à 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

Versions de l'API : V2

Parent : dynamic_profile_options

Valeur par défaut : false

Types de tâches compatibles : VOD

Exemple : vrai

Description :

Si la valeur est true, CAE veillera à ce que deux rendus n'utilisent pas la même combinaison de : résolution, fréquence d'images et profil de codec.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Par défaut : Le générateur de profils utilise des listes de résolutions standard pour tous les rapports hauteur / largeur connus. Dans la mesure du possible, le rapport hauteur / largeur, le rapport hauteur / largeur de l'échantillon et la fréquence d'images de la source sont conservés dans les configurations de sortie.

Types de tâches compatibles : VOD

Exemple : voir ci-dessous

Description :

Tableau de structures décrivant les résolutions, les fréquences d'images et les paramètres de codec associés qui devraient être générés de préférence ou de manière obligatoire dans le cadre de l'encodage CAE. Voir le section au dessous de.

        {
          "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

Versions de l'API : V2

Parent : dynamic_profile_options

Par défaut : Le générateur de profils utilise des listes de résolutions standard pour tous les rapports hauteur / largeur connus. Dans la mesure du possible, le rapport hauteur / largeur, le rapport hauteur / largeur de l'échantillon et la fréquence d'images de la source sont conservés dans les configurations de sortie.

Types de tâches compatibles : VOD

Exemple : voir ci-dessous

Description :

Un tableau de hachages décrivant filigranes.

    {
        "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%"
           }
          ]
        }
      }

Les filigranes peuvent également faire partie 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

Vous trouverez ci-dessous des paramètres d'encodage généraux supplémentaires pouvant être utilisés pour CAE.

Paramètres additionnels
Prénom	Type	Description	Défaut
`deblock`	Booléen	Appliquez un filtre de déblocage à la vidéo.	`false`
`deinterlace`	Chaîne	Détermine s'il faut appliquer ou non un filtre de désentrelacement. La valeur par défaut est « détecter » : si le fichier d'entrée est détecté comme entrelacé, il sera désentrelacé. Réglez ce paramètre sur "on" pour forcer le désentrelacement (ce qui réduira la qualité si l'entrée n'est pas entrelacée), ou "off" pour éviter le désentrelacement.	`detect`
`deinterlace_mode`	Chaîne	Si elles ne sont pas incluses ou définies sur `frame-to-frame`, les sorties Zencoder correspondront à la fréquence d'images du fichier d'entrée. Si ce paramètre est défini sur `field-to-frame`, Zencoder doublera la fréquence d'images du fichier d'entrée pour la sortie. Si vous choisissez manuellement `framerate` de doubler la fréquence d'images du fichier d'entrée, Zencoder `deinterlace_mode` définira `field-to-frame` et doublera automatiquement la fréquence d'images pour la sortie.	`frame-to-frame`
`denoise`	Chaîne	Appliquez un filtre de réduction du bruit à la vidéo. Les options valides sont `weak` `medium`, `strong`, et `strongest`. Réduit généralement la taille du fichier de 5% à 20%, en fonction du niveau de débruitage, du débit binaire et de la vidéo source. Tout débruitage ralentit le codage d'environ 20%. Les valeurs supérieures à «faible» doivent être utilisées avec précaution, bien que l'animation puisse parfois gérer un niveau élevé de débruitage.	`none (denoising not applied)`
`speed`	Entier	Réglage de la vitesse d'encodage.	`3`
`one_pass`	Booléen	Forcer l'encodage 1 passe.	`false`
`start_clip`	Chaîne / nombre	Créez un clip de la vidéo originale, en commençant à un moment donné. Il peut s'agir d'un code temporel au format `HH:MM:SS.S` ou un nombre décimal exprimant le nombre de secondes à partir duquel commencer.	`0`
`clip_length`	Chaîne / nombre	Créez un clip d'une longueur particulière. Cela peut être une durée avec un format de `HH:MM:SS.S` ou un nombre décimal exprimant la durée du clip en secondes.	durée de la source

Paramètres HDR

CAE prend également en charge HDR10 et les paramètres suivants peuvent être inclus dans dynamic_profile_options.

Paramètres additionnels
Prénom	Type	Description	Défaut
`master_display`	Objet	Hash contenant les paramètres de volume de couleur et de luminance pour les sorties HDR.	aucun
`max_content_light_level`	Entier	Niveau de lumière maximal pour le contenu sous forme de lentes entières ou de candelas par mètre carré (cd/m2) - valeurs entières.	aucun
`max_frame_average_light_level`	Entier	Niveau de lumière moyen maximal pour les trames de contenu, les lentes ou les candelas par mètre carré (cd/m2) - valeurs entières. Bien que des valeurs allant jusqu'à 10000 soient autorisées, les valeurs comprises entre 100 et 200 produiront généralement les meilleurs résultats.	aucun

Paramètres de configuration vidéo

Vous souhaiterez peut-être utiliser cette fonction si CAE ne produit pas de configurations spécifiques que vous devez avoir dans vos sorties.

Il s'agit d'un tableau d'objets décrivant les résolutions vidéo et les paramètres de codec que CAE doit / doit produire dans le cadre de sa sortie (voir le exemple ci-dessus). Ce tableau est optionnel. En cas d'omission, un tableau de résolutions par défaut, allant de 192 x 108 à la résolution du contenu, sera utilisé comme jeu d'entrée par défaut pour CAE.

Paramètres de configuration vidéo
Prénom	Type	Description	Obligatoire?
`width`	Entier	Largeur de l'image vidéo [pixels]	obligatoire
`height`	Entier	Hauteur de l'image vidéo [pixels]	obligatoire
`sample_aspect_ratio`	Paire entier : entier	Rapport d'aspect de l'échantillon (p. ex. 1:1, 4:3)	optionnel
`frame_rate`	Numéro	Fréquence d'images vidéo [fps]	optionnel
`video_codec_profile`	Chaîne	profil de codec vidéo	optionnel
`video_codec_level`	Chaîne	niveau de codec vidéo	optionnel
`video_reference_frames`	Entier	Contrainte sur le nombre de cadres de référence. Valeur par défaut = 4 (3 pour la ligne de base H.264).	optionnel
`video_bframes`	Entier	Contrainte sur le nombre de trames B. Valeur par défaut = 3 (0 pour la ligne de base H.264).	optionnel
`required`	Booléen	Définir ceci sur true garantira les paramètres de configuration suggérés dans la sortie. Par défaut = faux.	optionnel