Création de longs fichiers audio sur AWS CLI

La fonctionnalité de synthèse asynchrone d'Amazon Polly utilise trois SpeechSynthesisTask API pour traiter de grandes quantités de texte :

• StartSpeechSynthesisTask : lance une nouvelle tâche de synthèse.

• GetSpeechSynthesisTask : renvoie des détails concernant une tâche de synthèse précédemment soumise.

• ListSpeechSynthesisTasks : répertorie toutes les tâches de synthèse soumises.

Synthétisation de textes volumineux (StartSpeechSynthesisTask)

Si vous souhaitez créer un fichier audio plus volumineux que celui que vous pouvez créer avec l'opération SynthesizeSpeech en temps réel, utilisez l'opération StartSpeechSynthesisTask. Outre les arguments nécessaires à l'SynthesizeSpeechopération, le nom d'un compartiment Amazon S3 est StartSpeechSynthesisTask également requis. Deux autres arguments facultatifs sont également disponibles : un préfixe de clé pour le fichier de sortie et l'ARN d'une rubrique SNS si vous souhaitez recevoir des notifications d'état sur la tâche.

• OutputS3BucketName: nom du compartiment Amazon S3 dans lequel la synthèse doit être téléchargée. Ce compartiment doit se trouver dans la même région que le service Amazon Polly. En outre, l'utilisateur IAM utilisé pour effectuer l'appel doit avoir accès au bucket. [Obligatoire]

• OutputS3KeyPrefix : préfixe de clé pour le fichier de sortie. Utilisez ce paramètre si vous souhaitez enregistrer le fichier vocal de sortie dans une clé personnalisée semblable à un répertoire dans votre bucket. [Facultatif]

• SnsTopicArn : ARN de la rubrique SNS à utiliser si vous souhaitez recevoir des notifications concernant l'état de la tâche. Cette rubrique SNS doit se trouver dans la même région que le service Amazon Polly. En outre, l'utilisateur IAM utilisé pour effectuer l'appel doit avoir accès au sujet. [Facultatif]

Par exemple, l'exemple suivant peut être utilisé pour exécuter la start-speech-synthesis-task AWS CLI commande dans la région USA Est (Ohio) :

L' AWS CLI exemple suivant est formaté pour Unix, Linux et macOS. Pour Windows, remplacez le caractère de continuation Unix (\) à la fin de chaque ligne par un curseur (^) et utilisez des guillemets complets («) autour du texte saisi par des guillemets simples (') pour les balises intérieures.

aws polly start-speech-synthesis-task \
  --region us-east-2 \
  --endpoint-url "https://polly.us-east-2.amazonaws.com/" \
  --output-format mp3 \
  --output-s3-bucket-name your-bucket-name \
  --output-s3-key-prefix optional/prefix/path/file \
  --voice-id Joanna \
  --text file://text_file.txt

Cette opération génèrera une réponse similaire à celle de l'exemple ci-dessous :

"SynthesisTask": 
{
     "OutputFormat": "mp3",
     "OutputUri": "https://s3.us-east-2.amazonaws.com/your-bucket-name/optional/prefix/path/file.<task_id>.mp3",
     "TextType": "text",
     "CreationTime": [..],
     "RequestCharacters": [..],
     "TaskStatus": "scheduled",
     "TaskId": [task_id],
     "VoiceId": "Joanna"
 }

L'opération start-speech-synthesis-task renvoie plusieurs nouveaux champs :

• OutputUri : emplacement de votre fichier vocal de sortie.

• TaskId: identifiant unique pour la tâche de synthèse vocale générée par Amazon Polly.

• CreationTime : horodatage de la date de soumission initiale de la tâche.

• RequestCharacters : nombre de caractères facturables dans la tâche.

• TaskStatus : fournit des informations concernant l'état de la tâche soumise.

  Une fois votre tâche soumise, l'état initial affiche scheduled. Lorsqu'Amazon Polly commence à traiter la tâche, le statut passe à inProgress et plus tard, à completed ou. failed Si la tâche échoue, un message d'erreur sera renvoyé lors de l'appel de l' ListSpeechSynthesisTasks opération GetSpeechSynthesisTask or.

Lorsque la tâche est terminée, le fichier vocal s'ajoute à l'emplacement spécifié dans OutputUri.

Récupération d'informations sur votre tâche de synthèse vocale

Vous pouvez obtenir des informations sur une tâche, telles que les erreurs, l'état et d'autres détails, à l'aide de l'opération GetSpeechSynthesisTask. Pour ce faire, vous aurez besoin du task-id renvoyé par l'opération StartSpeechSynthesisTask.

Par exemple, l'exemple suivant peut être utilisé pour exécuter la get-speech-synthesis-task AWS CLI commande :

aws polly get-speech-synthesis-task \
--region us-east-2 \
--endpoint-url "https:// polly.us-east-2.amazonaws.com/" \
--task-id task identifier

Vous pouvez également afficher toutes les tâches de synthèse vocale que vous avez exécutées dans la région actuelle à l'aide de l'opération ListSpeechSynthesisTasks.

Par exemple, l'exemple suivant peut être utilisé pour exécuter la list-speech-synthesis-tasks AWS CLI commande :

aws polly list-speech-synthesis-tasks \
--region us-east-2 \
--endpoint-url "https:// polly.us-east-2.amazonaws.com/"