D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

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_2_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>

### `delete-lexicon`
<a name="polly_DeleteLexicon_cli_2_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-lexicon`
<a name="polly_GetLexicon_cli_2_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*. 

### `get-speech-synthesis-task`
<a name="polly_GetSpeechSynthesisTask_cli_2_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*. 

### `list-lexicons`
<a name="polly_ListLexicons_cli_2_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*. 

### `list-speech-synthesis-tasks`
<a name="polly_ListSpeechSynthesisTasks_cli_2_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-lexicon`
<a name="polly_PutLexicon_cli_2_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 fichier `example.pls` spécifie un lexique W3C compatible avec PLS.  

```
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*. 

### `start-speech-synthesis-task`
<a name="polly_StartSpeechSynthesisTask_cli_2_topic"></a>

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

**AWS CLI**  
**Pour synthétiser du texte**  
L'`start-speech-synthesis-task`exemple suivant synthétise le texte `text_file.txt` et stocke le MP3 fichier 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*.