Transcrire à l'aide duAWS CLI

Lorsque vous utilisez leAWS CLI pour démarrer une transcription, vous pouvez exécuter toutes les commandes au niveau de la CLI. Vous pouvez également exécuter la commande que vous souhaitez utiliser, suivie duRégion AWS et de l'emplacement d'un fichier JSON contenant un corps de requête. Les exemples présentés dans ce guide illustrent les deux méthodes ; toutefois, cette section se concentre sur la première méthode.

IlAWS CLI ne prend pas en charge les transcriptions en streaming.

Avant de continuer, assurez-vous d'avoir :

• Vous avez chargé votre fichier multimédia dans unAmazon S3 compartiment. Si vous ne savez pas comment créer unAmazon S3 compartiment ou charger votre fichier, reportez-vous aux sections Créer votre premierAmazon S3 compartiment et Charger un objet dans votre compartiment.

• A installé le AWS CLI.

Vous pouvez trouver toutes lesAWS CLI commandes correspondantesAmazon Transcribe dans la référence desAWS CLI commandes.

Commencer un nouveau travail de transcription

Pour démarrer une nouvelle transcription, utilisez lastart-transcription-job commande.

1. Dans une fenêtre d'un terminal, entrez ce qui suit :

   aws transcribe start-transcription-job \

   Un «> » apparaît sur la ligne suivante et vous pouvez maintenant continuer à ajouter les paramètres requis, comme décrit à l'étape suivante.

   Vous pouvez également omettre le «\ » et ajouter tous les paramètres, en les séparant par un espace.

2. Avec lastart-transcription-job commande, vous devez inclureregiontranscription-job-name,media, etlanguage-code soitidentify-language.

   Si vous souhaitez spécifier un emplacement de sortie,output-bucket-name incluez-le dans votre demande ; si vous souhaitez spécifier un sous-dossier du compartiment de sortie spécifié, incluez-le égalementoutput-key.

   aws transcribe start-transcription-job \
    --region us-west-2 \
    --transcription-job-name my-first-transcription-job \
    --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac \
    --language-code en-US

   Si vous ajoutez tous les paramètres, cette requête se présente comme suit :

   aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac --language-code en-US

   Si vous choisissez de ne pas spécifier de compartiment de sortie en utilisantoutput-bucket-name,Amazon Transcribe place votre sortie de transcription dans un compartiment géré par le service. Les transcriptions stockées dans un compartiment géré par les services expirent au bout de 90 jours.

   Amazon Transcriberépond par :

   {
       "TranscriptionJob": {
           "TranscriptionJobName": "my-first-transcription-job",
           "TranscriptionJobStatus": "IN_PROGRESS",
           "LanguageCode": "en-US",
           "Media": {
               "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
           },
           "StartTime": "2022-03-07T15:03:44.246000-08:00",
           "CreationTime": "2022-03-07T15:03:44.229000-08:00"
       }
   }

Votre travail de transcription est réussi si TranscriptionJobStatusvous passez deIN_PROGRESS àCOMPLETED. Pour voir les mises à jour TranscriptionJobStatus, utilisez lalist-transcription-job commandeget-transcription-job ou, comme indiqué dans la section suivante.

Obtention du statut d'une tâche d'.

Pour obtenir des informations sur votre tâche d'exécution, utilisez laget-transcription-job commande.

Les seuls paramètres requis pour cette commande sont l'Région AWSemplacement et le nom de la tâche.

aws transcribe get-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Amazon Transcriberépond par :

{
    "TranscriptionJob": {
        "TranscriptionJobName": "my-first-transcription-job",
        "TranscriptionJobStatus": "COMPLETED",
        "LanguageCode": "en-US",
        "MediaSampleRateHertz": 48000,
        "MediaFormat": "flac",
        "Media": {
            "MediaFileUri": "s3://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
        },
        "Transcript": {
            "TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
        },
        "StartTime": "2022-03-07T15:03:44.246000-08:00",
        "CreationTime": "2022-03-07T15:03:44.229000-08:00",
        "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
        "Settings": {
            "ChannelIdentification": false,
            "ShowAlternatives": false
        }
    }
}

Si vous avez sélectionné votre propreAmazon S3 compartiment pour la sortie de votre transcription, ce compartiment est répertorié avecTranscriptFileUri. Si vous avez sélectionné un compartiment géré par les services, un URI temporaire est fourni ; utilisez cet URI pour télécharger votre transcription.

Note

Les URI temporaires pour lesAmazon S3 compartiments gérés par les services ne sont valides que pendant 15 minutes. Si vous obtenez uneAccesDenied erreur lors de l'utilisation de l'URI, exécutez à nouveau laget-transcription-job demande pour obtenir un nouvel URI temporaire.

Répertorier vos tâches de transcription

Pour répertorier toutes vos tâches de transcription dans un mêmeRégion AWS fichier, utilisez lalist-transcription-jobs commande.

Le seul paramètre requis pour cette commande est celuiRégion AWS dans lequel se trouvent vos tâches de transcription.

aws transcribe list-transcription-jobs \
 --region us-west-2

Amazon Transcriberépond par :

{
    "NextToken": "A-very-long-string",
    "TranscriptionJobSummaries": [
        {
            "TranscriptionJobName": "my-first-transcription-job",
            "CreationTime": "2022-03-07T15:03:44.229000-08:00",
            "StartTime": "2022-03-07T15:03:44.246000-08:00",
            "CompletionTime": "2022-03-07T15:04:01.158000-08:00",
            "LanguageCode": "en-US",
            "TranscriptionJobStatus": "COMPLETED",
            "OutputLocationType": "SERVICE_BUCKET"
        }        
    ]
}

Supprimer votre tâche de transcription

Pour supprimer votre tâche de transcription, utilisez ladelete-transcription-job commande.

Les seuls paramètres requis pour cette commande sont l'Région AWSemplacement et le nom de la tâche.

aws transcribe delete-transcription-job \
 --region us-west-2 \
 --transcription-job-name my-first-transcription-job

Pour confirmer que votre demande de suppression est réussie, vous pouvez exécuter lalist-transcription-jobs commande. Votre tâche d'action ne doit plus apparaître dans la liste.