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.

# Exemples d'utilisation d'Amazon Polly AWS CLI
<a name="cli_polly_code_examples"></a>

Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l' AWS Command Line Interface aide d'Amazon Polly.

Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés.

Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte.

**Topics**
+ [Actions](#actions)

## Actions
<a name="actions"></a>

### `supprime-lexique`
<a name="polly_DeleteLexicon_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`delete-lexicon`.

**AWS CLI**  
**Pour supprimer un lexique**  
L’exemple `delete-lexicon` suivant supprime le lexique spécifié.  

```
aws polly delete-lexicon \
    --name {{w3c}}
```
Cette commande ne produit aucune sortie.  
Pour plus d'informations, consultez la section [Utilisation de l' DeleteLexicon opération](https://docs.aws.amazon.com/polly/latest/dg/gs-delete-lexicon.html) dans le manuel *Amazon Polly Developer Guide*.  
+  Pour plus de détails sur l'API, reportez-vous [DeleteLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/delete-lexicon.html)à la section *Référence des AWS CLI commandes*. 

### `get-lexique`
<a name="polly_GetLexicon_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`get-lexicon`.

**AWS CLI**  
**Pour extraire le contenu d’un lexique**  
L’exemple `get-lexicon` suivant récupère le contenu du lexique de prononciation spécifié.  

```
aws polly get-lexicon \
    --name {{w3c}}
```
Sortie :  

```
{
    "Lexicon": {
        "Content": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<lexicon version=\"1.0\" \n      xmlns=    \"http://www.w3.org/2005/01/pronunciation-lexicon\"\n      xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" \n          xsi:schemaLocation=\"http://www.w3.org/2005/01/pronunciation-lexicon \n        http://www.w3.org/TR/2007/CR-pronunciation-    lexicon-20071212/pls.xsd\"\n      alphabet=\"ipa\" \n      xml:lang=\"en-US\">\n  <lexeme>\n    <grapheme>W3C</grapheme>\n        <alias>World Wide Web Consortium</alias>\n  </lexeme>\n</lexicon>\n",
        "Name": "w3c"
    },
    "LexiconAttributes": {
        "Alphabet": "ipa",
        "LanguageCode": "en-US",
        "LastModified": 1603908910.99,
        "LexiconArn": "arn:aws:polly:us-west-2:880185128111:lexicon/w3c",
        "LexemesCount": 1,
        "Size": 492
    }
}
```
Pour plus d'informations, consultez la section [Utilisation de l' GetLexicon opération](https://docs.aws.amazon.com/polly/latest/dg/gs-get-lexicon.html) dans le manuel *Amazon Polly Developer Guide*.  
+  Pour plus de détails sur l'API, reportez-vous [GetLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-lexicon.html)à la section *Référence des AWS CLI commandes*. 

### `tâche de synthèse vocale get-speech-task`
<a name="polly_GetSpeechSynthesisTask_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`get-speech-synthesis-task`.

**AWS CLI**  
**Pour obtenir les informations sur une tâche de synthèse vocale**  
L’exemple `get-speech-synthesis-task` suivant récupère les informations sur la tâche de synthèse vocale spécifiée.  

```
aws polly get-speech-synthesis-task \
    --task-id {{70b61c0f-57ce-4715-a247-cae8729dcce9}}
```
Sortie :  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "completed",
        "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
Pour plus d’informations, consultez [Création de fichiers audio longs](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) dans le *Guide du développeur Amazon Polly*.  
+  Pour plus de détails sur l'API, reportez-vous [GetSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/get-speech-synthesis-task.html)à la section *Référence des AWS CLI commandes*. 

### `lexiques de listes`
<a name="polly_ListLexicons_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`list-lexicons`.

**AWS CLI**  
**Pour répertorier vos lexiques**  
L’exemple `list-lexicons` suivant répertorie vos lexiques de prononciation.  

```
aws polly list-lexicons
```
Sortie :  

```
{
    "Lexicons": [
        {
            "Name": "w3c",
            "Attributes": {
                "Alphabet": "ipa",
                "LanguageCode": "en-US",
                "LastModified": 1603908910.99,
                "LexiconArn": "arn:aws:polly:us-east-2:123456789012:lexicon/w3c",
                "LexemesCount": 1,
                "Size": 492
            }
        }
    ]
}
```
Pour plus d'informations, consultez la section [Utilisation de l' ListLexicons opération](https://docs.aws.amazon.com/polly/latest/dg/gs-list-lexicons.html) dans le manuel *Amazon Polly Developer Guide*.  
+  Pour plus de détails sur l'API, reportez-vous [ListLexicons](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-lexicons.html)à la section *Référence des AWS CLI commandes*. 

### `lister les tâches de synthèse vocale`
<a name="polly_ListSpeechSynthesisTasks_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`list-speech-synthesis-tasks`.

**AWS CLI**  
**Pour répertorier vos tâches de synthèse vocale**  
L’exemple `list-speech-synthesis-tasks` suivant répertorie vos tâches de synthèse vocale.  

```
aws polly list-speech-synthesis-tasks
```
Sortie :  

```
{
    "SynthesisTasks": [
        {
            "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
            "TaskStatus": "completed",
            "OutputUri": "https://s3.us-west-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
            "CreationTime": 1603911042.689,
            "RequestCharacters": 1311,
            "OutputFormat": "mp3",
            "TextType": "text",
            "VoiceId": "Joanna"
        }
    ]
}
```
Pour plus d’informations, consultez [Création de fichiers audio longs](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) dans le *Guide du développeur Amazon Polly*.  
+  Pour plus de détails sur l'API, reportez-vous [ListSpeechSynthesisTasks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/list-speech-synthesis-tasks.html)à la section *Référence des AWS CLI commandes*. 

### `put-lexique`
<a name="polly_PutLexicon_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`put-lexicon`.

**AWS CLI**  
**Pour enregistrer un lexique**  
L’exemple `put-lexicon` suivant enregistre le lexique de prononciation spécifié. Le `example.pls` fichier spécifie un PLS-compliant lexique W3C.  

```
aws polly put-lexicon \
    --name {{w3c}} \
    --content {{file://example.pls}}
```
Contenu de `example.pls`  

```
{
    <?xml version="1.0" encoding="UTF-8"?>
    <lexicon version="1.0"
        xmlns="http://www.w3.org/2005/01/pronunciation-lexicon"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="http://www.w3.org/2005/01/pronunciation-lexicon
            http://www.w3.org/TR/2007/CR-pronunciation-lexicon-20071212/pls.xsd"
        alphabet="ipa"
        xml:lang="en-US">
        <lexeme>
            <grapheme>W3C</grapheme>
            <alias>World Wide Web Consortium</alias>
        </lexeme>
    </lexicon>
}
```
Cette commande ne produit aucune sortie.  
Pour plus d'informations, consultez la section [Utilisation de l' PutLexicon opération](https://docs.aws.amazon.com/polly/latest/dg/gs-put-lexicon.html) dans le manuel *Amazon Polly Developer Guide*.  
+  Pour plus de détails sur l'API, reportez-vous [PutLexicon](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/put-lexicon.html)à la section *Référence des AWS CLI commandes*. 

### `tâche de synthèse vocale de démarrage`
<a name="polly_StartSpeechSynthesisTask_cli_topic"></a>

L'exemple de code suivant montre comment utiliser`start-speech-synthesis-task`.

**AWS CLI**  
**Pour synthétiser du texte**  
L’exemple `start-speech-synthesis-task` suivant synthétise le texte dans `text_file.txt` et stocke le fichier MP3 obtenu dans le compartiment spécifié.  

```
aws polly start-speech-synthesis-task \
    --output-format {{mp3}} \
    --output-s3-bucket-name {{amzn-s3-demo-bucket}} \
    --text  {{file://text_file.txt}} \
    --voice-id {{Joanna}}
```
Sortie :  

```
{
    "SynthesisTask": {
        "TaskId": "70b61c0f-57ce-4715-a247-cae8729dcce9",
        "TaskStatus": "scheduled",
        "OutputUri": "https://s3.us-east-2.amazonaws.com/amzn-s3-demo-bucket/70b61c0f-57ce-4715-a247-cae8729dcce9.mp3",
        "CreationTime": 1603911042.689,
        "RequestCharacters": 1311,
        "OutputFormat": "mp3",
        "TextType": "text",
        "VoiceId": "Joanna"
    }
}
```
Pour plus d’informations, consultez [Création de fichiers audio longs](https://docs.aws.amazon.com/polly/latest/dg/longer-cli.html) dans le *Guide du développeur Amazon Polly*.  
+  Pour plus de détails sur l'API, reportez-vous [StartSpeechSynthesisTask](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/polly/start-speech-synthesis-task.html)à la section *Référence des AWS CLI commandes*.