Paramètres vidéo

video_bit_depth

Versions de l'API : V2

Parent : outputs

Par défaut : dix

Valeurs valides : 8, 10 ou 12

Types de tâches compatibles : vod, live

Exemple : 5

Description :

Le nombre de bits par canal de couleur.

Normalement, vous ne définissez pas ceci et spécifiez video_codec_profile ce qui fournirait la profondeur de bits.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "video_bit_depth": 10
    }
  ]
}

video_reference_frames

Versions de l'API : V2

Parent : outputs

Par défaut : 3

Valeurs valides : 0-16, auto

Types de tâches compatibles : vod, live

Exemple : 5

Description :

Nombre de cadres de référence à utiliser.

Plus de trames de référence entraînent une qualité de compression légèrement supérieure, mais une complexité de décodage accrue. En pratique, aller au-dessus de 5 a rarement beaucoup d'avantages.

Déterminé en partie par speed aussi bien que video_codec_profile. Réglez sur "auto" pour autoriser notre speed réglage pour choisir naturellement ce nombre.

La valeur par défaut est 3 comme un bon compromis de complexité de compression et de décodage.

Utilisez 1 pour les vidéos créées pour les anciens iPod ou les vidéos iPhone de première génération, ou pour d'autres décodeurs techniquement limités.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "video_reference_frames": 5
    }
  ]
}

video_codec_profile

Versions de l'API : V2

Parent : outputs

Par défaut : H.264 : baseline, HEVC : main, VP9 : 0

Valeurs valides : dépendantes du codec

Types de tâches compatibles : VOD

Exemple : élevé

Description :

Définit le profil d'encodage utilisé par le codec vidéo.

• Profils H.264 : baseline, main, high, high10 high422, high444.
• Profils HEVC : main, main10, main12, main422-10, main422-12, main444-8, main444-10, main444-12.
• Profils VP9 : 0, 1, 2, 3.
• Profils AV1 : main high et professional. Par défaut : main.

En général, les niveaux inférieurs sont pris en charge par une gamme plus large d'appareils et peuvent être plus simples à décoder. Les niveaux supérieurs offrent plus de fonctionnalités telles que des profondeurs de bits supplémentaires et des choix de sous-échantillonnage de chrominance. Dans certains cas, des niveaux plus élevés prennent également en charge une efficacité de compression accrue.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "video_codec_profile": "high"
    }
  ]
}

video_codec_level

Versions de l'API : V2

Parent : outputs

Par défaut : Calculé automatiquement à l'aide d'un graphique de niveaux basé sur la vidéo de sortie. Voir niveaux H.264, niveaux HEVC.

Valeurs valides : Un niveau valide : Niveaux H.264, niveaux HEVC.

Types de tâches compatibles : VOD

Exemple : 4.1

Description :

Contraint le débit binaire, les macroblocs (H.264) ou le débit binaire, les unités d'arbre de codage (HEVC)

Principalement utilisé pour la compatibilité des appareils. Par exemple, l'iPhone prend en charge H.264 Niveau 3, ce qui signifie qu'une vidéo est decoder_bitrate_cap ne peut pas dépasser 10 000 kbps. En règle générale, vous ne devez modifier ce paramètre que si vous ciblez un appareil spécifique qui en a besoin.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "video_codec_level": "4.1"
    }
  ]
}

video_bframes

Versions de l'API : V2

Parent : outputs

Par défaut : 0

Valeurs valides : 0-16

Types de tâches compatibles : VOD

Exemple : 2

Description :

Nombre maximum d'images B consécutives.

L'utilisation d'images B peut augmenter la qualité au même débit, mais est plus exigeante pour les processeurs. Cela peut être problématique sur les vieux ordinateurs ou appareils, mais fonctionne généralement sans problème sur le matériel moderne.

H.264 prend en charge par des cadres b avec Main or High profile , pas de base. La valeur par défaut est 0 pour la compatibilité la plus large.

Pour HEVC, les cadres b peuvent être utilisés à n'importe quel niveau. La valeur par défaut est 3.

Nous recommandons une valeur de 3 pour les améliorations de compression/qualité. Les valeurs supérieures à 5 ou 6 offrent rarement beaucoup d'avantages et augmentent considérablement le temps de codage.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "video_bframes": 2
    }
  ]
}

Voir également: video_codec_profile

color_metadata

Versions de l'API : V2

Parent : outputs

Par défaut : preserve

Valeurs valides : preserve ou discard

Types de tâches compatibles : VOD

Exemple : discard

Description :

Cette option est actuellement prise en charge sur les sorties H.264, HEVC et VP9. Si la vidéo d'entrée a des coefficients de matrice, des caractéristiques de transfert et des métadonnées de couleurs primaires, Zencoder preserve ces paramètres par défaut.

Pour vous assurer que ces métadonnées ne sont pas intégrées aux sorties, définissez color_metadata à discard.

{
  "input": "s3://zencodertesting/test.mov",
  "outputs": [
    {
      "color_metadata": "discard"
    }
  ]
}