

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création de sous-titres de vidéo
<a name="subtitles"></a>

Amazon Transcribe prend en charge les sorties WebVTT (\$1.vtt) SubRip et (\$1.srt) pour les utiliser comme sous-titres vidéo. Vous pouvez sélectionner un ou les deux types de fichiers lors de la configuration de votre tâche de transcription vidéo par lots. Lorsque vous utilisez la fonctionnalité de sous-titrage, le ou les fichiers de sous-titres sélectionnés et un fichier de transcription normal (contenant des informations supplémentaires) sont produits. Les fichiers de sous-titres et de transcription sont envoyés vers la même destination.

Les sous-titres s’affichent en même temps que le texte est prononcé et restent visibles jusqu’à ce qu’il y ait une pause naturelle ou que le locuteur ait fini de parler. Notez que si vous activez les sous-titres dans votre demande de transcription et que votre audio ne contient pas de paroles, aucun fichier de sous-titres n’est créé.

**Important**  
Amazon Transcribe utilise un indice de départ par défaut de `0` pour la sortie des sous-titres, qui diffère de la valeur la plus couramment utilisée de`1`. Si vous avez besoin d'un index de départ de`1`, vous pouvez le spécifier dans AWS Management Console ou dans votre demande d'API à l'aide du [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html#transcribe-Type-Subtitles-OutputStartIndex](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html#transcribe-Type-Subtitles-OutputStartIndex)paramètre.

L’utilisation d’un indice de départ incorrect peut entraîner des erreurs de compatibilité avec d’autres services. Assurez-vous donc de vérifier l’indice de départ dont vous avez besoin avant de créer vos sous-titres. Si vous n’êtes pas certain de la valeur à utiliser, nous vous recommandons de choisir `1`. Pour plus d’informations, consultez la section [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

Fonctionnalités prises en charge avec les sous-titres :
+ **Expurgation de contenu** – Tout contenu expurgé est indiqué comme « `PII` » dans vos fichiers de sortie de sous-titres et de transcription normale. L’audio n’est pas modifié.
+ **Filtres de vocabulaire** – Les fichiers de sous-titres sont générés à partir du fichier de transcription, de sorte que tous les mots que vous filtrez dans votre sortie de transcription standard sont également filtrés dans vos sous-titres. Le contenu filtré est affiché sous forme d’espaces blancs ou « `***` » dans vos fichiers de transcription et de sous-titres. L’audio n’est pas modifié.
+ **Diarisation du locuteur** – Si un segment de sous-titre donné contient plusieurs locuteurs, des tirets sont utilisés pour distinguer chaque locuteur. Cela s'applique à la fois au WebVTT SubRip et aux formats ; par exemple :
  + -- Texte prononcé par la personne 1
  + -- Texte prononcé par la personne 2

Les fichiers de sous-titres sont stockés au même Amazon S3 endroit que votre sortie de transcription.

Pour une présentation vidéo de la création de sous-titres, voir :

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/PZdfXGggcH4/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/PZdfXGggcH4)


## Génération de fichiers de sous-titres
<a name="subtitles-how-to"></a>

Vous pouvez créer des fichiers de sous-titres à l'aide du **AWS Management Console**AWS CLI****, ou **AWS SDKs**; consultez les exemples suivants :

### AWS Management Console
<a name="subtitles-console"></a>

1. Connectez-vous à la [AWS Management Console](https://console.aws.amazon.com/transcribe/).

1. Dans le volet de navigation, choisissez **Tâches de transcription**, puis sélectionnez **Créer une tâche** (en haut à droite). La page **Spécifier les détails de la tâche** s’ouvre. Les options de sous-titres se trouvent dans le volet **Données de sortie**.

1. Sélectionnez les formats souhaités pour vos fichiers de sous-titres, puis choisissez une valeur pour votre indice de départ. Notez que la Amazon Transcribe valeur par défaut est`0`, mais `1` qu'elle est plus largement utilisée. Si vous ne savez pas quelle valeur utiliser, nous vous recommandons de choisir `1`, car cela peut améliorer la compatibilité avec d’autres services.  
![\[Amazon Transcribe capture d'écran de la console : le volet « données de sortie » sur la page « Spécifier les détails de la tâche ».\]](http://docs.aws.amazon.com/fr_fr/transcribe/latest/dg/images/subtitles-startindex.png)

1. Renseignez les autres champs que vous souhaitez inclure sur la page **Spécifier les détails de la tâche**, puis sélectionnez **Suivant**. Vous accédez alors à la page **Configurer la tâche - *facultatif***.

1. Sélectionnez **Créer une tâche** pour exécuter votre tâche de transcription. 

### AWS CLI
<a name="subtitles-cli"></a>

Cet exemple utilise la [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)commande et le `Subtitles` paramètre. Pour plus d’informations, consultez [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) et [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-bucket-name amzn-s3-demo-bucket \
--output-key my-output-files/ \
--language-code en-US \
--subtitles Formats=vtt,srt,OutputStartIndex=1
```

Voici un autre exemple d'utilisation de la [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)commande et d'un corps de requête qui ajoute des sous-titres à cette tâche.

```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://my-first-subtitle-job.json
```

Le fichier *my-first-subtitle-job.json* contient le corps de requête suivant.

```
{
  "TranscriptionJobName": "my-first-transcription-job",
  "Media": {
        "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "amzn-s3-demo-bucket",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "Subtitles": {
        "Formats": [
            "vtt","srt"
        ],             
        "OutputStartIndex": 1
   }
}
```

### AWS SDK pour Python (Boto3)
<a name="subtitles-python-batch"></a>

Cet exemple utilise le AWS SDK pour Python (Boto3) pour ajouter des sous-titres à l'aide de l'`Subtitles`argument de la méthode [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Pour plus d’informations, consultez [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) et [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Subtitles.html).

Pour des exemples supplémentaires utilisant le AWS SDKs, notamment des exemples spécifiques aux fonctionnalités, des scénarios et des exemples multiservices, reportez-vous au chapitre. [Exemples de code pour Amazon Transcribe à l'aide de AWS SDKs](service_code_examples.md)

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'amzn-s3-demo-bucket',
    OutputKey = 'my-output-files/', 
    LanguageCode = 'en-US', 
    Subtitles = {
        'Formats': [
            'vtt','srt'
        ],
        'OutputStartIndex': 1 
   }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```