本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用列表创建自定义词汇表
<a name="custom-vocabulary-create-list"></a>

**重要**  
不推荐使用列表格式的自定义词汇表，因此，如果您要创建新的自定义词汇表，我们强烈建议您使用[表格格式](custom-vocabulary-create-table.md)。

您可以使用 AWS 管理控制台、 AWS CLI或 AWS SDK 从列表中创建自定义词汇表。
+ **AWS 管理控制台**：您必须创建并上传包含自定义词汇表的文本文件。您可以使用行分隔或逗号分隔的条目。请注意，您的列表必须另存为文本 (\*.txt) 文件。同时支持`LF`和`CRLF`行尾。
+ **AWS CLI** 和 **AWS SDK**：您必须使用 [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) 标志将自定义词汇表作为逗号分隔的条目包含在 API 调用中。

如果一个条目包含多个单词，则必须用连字符连接每个单词。例如，以 **Los-Angeles** 形式添加“Los Angeles”，以 **Andorra-la-Vella** 形式添加“Andorra la Vella”。

以下是两种有效列表格式的示例。有关特定于方法的示例，请参阅[创建自定义词汇表](#custom-vocabulary-create-list-examples)。
+ Comma-separated 参赛作品：

  ```
  Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
  ```
+ Line-separated 参赛作品：

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

**重要**  
您只能使用您的语言支持的字符。有关详细信息，请参阅您的语言的[字符集](charsets.md)。

[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html) 操作不支持自定义词汇表列表。如果要创建自定义医学词汇表，则必须使用表格格式；有关说明，请参阅[使用表格创建自定义词汇表](custom-vocabulary-create-table.md)。

## 创建自定义词汇表
<a name="custom-vocabulary-create-list-examples"></a>

要处理用于的自定义词汇表 Amazon Transcribe，请参阅以下示例：

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

此示例结合列表格式的自定义词汇表文件使用 [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) 命令。有关更多信息，请参阅 [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}}}
```

以下是另一个使用 [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) 命令的示例，以及创建自定义词汇表的请求正文。

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

*my-first-vocab-list.json* 文件包含以下请求正文。

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

`VocabularyState` 从 `PENDING` 变为 `READY` 后，您的自定义词汇表就可以用于转录了。要查看自定义词汇表的当前状态，请运行：

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

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

此示例使用 c [reate\_vorquary 方法从列表中创建自定义词汇表](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary)。 适用于 Python (Boto3) 的 AWS SDK 有关更多信息，请参阅 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)。

有关使用 AWS 软件开发工具包的其他示例，包括特定功能、场景和跨服务示例，请参阅本章。[使用 Amazon Transcribe 的代码示例 AWS 软件开发工具包](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)
```

**注意**  
如果您为自定义词汇文件创建新的 Amazon S3 存储桶，请确保[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)发出请求的 IAM 角色有权访问此存储桶。如果角色不具备相应的权限，则请求将失败。您可以选择在请求中添加`DataAccessRoleArn`参数来指定 IAM 角色。有关 IAM 角色和策略的更多信息 Amazon Transcribe，请参阅[Amazon Transcribe 基于身份的策略示例](security_iam_id-based-policy-examples.md)。