

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 d’un vocabulaire personnalisé à l’aide d’une liste
<a name="custom-vocabulary-create-list"></a>

**Important**  
Les vocabulaires personnalisés sous forme de listes sont obsolètes. Par conséquent, si vous créez un nouveau vocabulaire personnalisé, nous vous recommandons vivement d’utiliser le [format de tableau.](custom-vocabulary-create-table.md)

Vous pouvez créer des vocabulaires personnalisés à partir de listes en utilisant le AWS Management Console AWS CLI, ou. AWS SDKs
+ **AWS Management Console** : vous devez créer et télécharger un fichier texte contenant votre vocabulaire personnalisé. Vous pouvez utiliser des entrées séparées par des lignes ou des virgules. Notez que votre liste doit être enregistrée sous forme de fichier texte (\$1.txt) au format `LF`. Si vous utilisez un autre format, comme le format `CRLF`, votre vocabulaire personnalisé n’est pas accepté par Amazon Transcribe.
+ **AWS CLI**et **AWS SDKs**: Vous devez inclure votre vocabulaire personnalisé sous forme d'entrées séparées par des virgules dans votre appel d'API à l'aide de l'[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html#transcribe-CreateVocabulary-request-Phrases)indicateur.

Si une entrée contient plusieurs mots, vous devez couper chaque mot par un trait d’union. Par exemple, vous incluez « Los Angeles » sous la forme **Los-Angeles** et « Andorre-la-Vieille » sous la forme **Andorra-la-Vella**.

Voici des exemples des deux formats de liste valides. Reportez-vous aux sections [Création de listes de vocabulaires personnalisés](#custom-vocabulary-create-list-examples) pour des exemples spécifiques à la méthode.
+ Entrées séparées par des virgules :

  ```
  Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
  ```
+ Entrées séparées par des lignes :

  ```
  Los-Angeles
  CLI
  Eva-Maria
  ABCs
  Andorra-la-Vella
  ```

**Important**  
Vous ne pouvez utiliser que des caractères pris en charge pour votre langue. Reportez-vous au [jeu de caractères](charsets.md) de votre langue pour plus de détails.

Les listes de vocabulaires personnalisés ne sont pas prises en charge par l’opération [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html). Si vous créez un vocabulaire médical personnalisé, vous devez utiliser un format de tableau. Consultez la section [Création d’un vocabulaire personnalisé à l’aide d’un tableau](custom-vocabulary-create-table.md) pour des instructions.

## Création de listes de vocabulaires personnalisés
<a name="custom-vocabulary-create-list-examples"></a>

Pour traiter une liste de vocabulaire personnalisée à utiliser avec Amazon Transcribe, consultez les exemples suivants :

### AWS CLI
<a name="vocab-create-list-cli"></a>

Cet exemple utilise la commande [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) avec un fichier de vocabulaire personnalisé sous forme de liste. Pour de plus amples informations, veuillez consulter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).

```
aws transcribe create-vocabulary \ 
--vocabulary-name my-first-vocabulary \ 
--language-code en-US \ 
--phrases {CLI,Eva-Maria,ABCs}
```

Voici un autre exemple d’utilisation de la commande [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) et d’un corps de requête qui crée votre vocabulaire personnalisé.

```
aws transcribe create-vocabulary \
--cli-input-json file://filepath/my-first-vocab-list.json
```

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

```
{
  "VocabularyName": "my-first-vocabulary",
  "LanguageCode": "en-US",
  "Phrases": [
        "CLI","Eva-Maria","ABCs"
  ]
}
```

Lorsque `VocabularyState` passe de `PENDING` à `READY`, votre vocabulaire personnalisé est prêt à être utilisé avec une transcription. Pour afficher le statut actuel de votre vocabulaire personnalisé, exécutez :

```
aws transcribe get-vocabulary \
--vocabulary-name my-first-vocabulary
```

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

Cet exemple utilise le AWS SDK pour Python (Boto3) pour créer un vocabulaire personnalisé à partir d'une liste à l'aide de la méthode [create\$1vocabulary](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary). Pour de plus amples informations, veuillez consulter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.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')
vocab_name = "my-first-vocabulary"
response = transcribe.create_vocabulary(
    LanguageCode = 'en-US',
    VocabularyName = vocab_name,
    Phrases = [
        'CLI','Eva-Maria','ABCs'
    ]
)

while True:
    status = transcribe.get_vocabulary(VocabularyName = vocab_name)
    if status['VocabularyState'] in ['READY', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

**Note**  
Si vous créez un nouveau Amazon S3 compartiment pour vos fichiers de vocabulaire personnalisés, assurez-vous que le IAM rôle à l'origine de la [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)demande est autorisé à accéder à ce compartiment. Si le rôle ne dispose pas des autorisations appropriées, votre demande échoue. Vous pouvez éventuellement spécifier un IAM rôle dans votre demande en incluant le `DataAccessRoleArn` paramètre. Pour plus d'informations sur IAM les rôles et les politiques dans Amazon Transcribe, voir[Amazon Transcribe exemples de politiques basées sur l'identité](security_iam_id-based-policy-examples.md).