

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 사용자 지정 어휘 필터를 사용하여 단어 삭제, 마스킹 또는 플래그 지정
<a name="vocabulary-filtering"></a>

사용자 지정 어휘 필터는 트랜스크립션 출력에서 수정할 개별 단어의 사용자 지정 목록이 포함된 텍스트 파일입니다.

일반적인 사용 사례는 모욕적이거나 비속한 용어를 제거하는 것이지만, 사용자 지정 어휘 필터는 전적으로 사용자가 지정하므로 원하는 단어를 선택할 수 있습니다. 예를 들어 새 제품이 곧 출시될 경우 회의 트랜스크립트에서 제품 이름을 숨길 수 있습니다. 이 경우 출시 전까지 제품 이름을 비밀로 유지하면서 이해 관계자에게 최신 정보를 알릴 수 있습니다.

어휘 필터링에는`mask`, `remove`, `tag`의 세 가지 표시 방법이 있습니다. 각 예시의 작동 방식을 보려면 다음 예를 참조하세요.
+ **마스킹**: 지정된 단어를 별표 3개(\$1\$1\$1) 로 바꿉니다.

  ```
  "transcript": "You can specify a list of *** or *** words, and *** *** removes them from transcripts automatically."
  ```
+ **제거**: 지정된 단어를 삭제하고 그 위치에 아무것도 남기지 않습니다.

  ```
  "transcript": "You can specify a list of or words, and removes them from transcripts automatically."
  ```
+ **태그**: 지정된 각 단어에 태그(`"vocabularyFilterMatch": true`)를 추가하지만 단어 자체는 변경하지 않습니다. 태그를 지정하면 트랜스크립트를 빠르게 대체하고 편집할 수 있습니다.

  ```
  "transcript": "You can specify a list of profane or offensive words, and amazon transcribe removes them from transcripts automatically."
  ...
      "alternatives": [
          {
              "confidence": "1.0",
              "content": "profane"
          }
      ],
      "type": "pronunciation",
      "vocabularyFilterMatch": true
  ```

트랜스크립션 요청을 제출할 때 사용자 지정 어휘 필터와 적용하려는 필터링 방법을 지정할 수 있습니다. 그러면 Amazon Transcribe는 지정한 필터링 방법에 따라 스크립트에 나타나는 정확한 단어 일치 항목을 수정합니다.

사용자 지정 어휘 필터는 배치 및 스트리밍 트랜스크립션 요청에 적용할 수 있습니다. 사용자 지정 어휘 필터를 생성하는 방법을 알아보려면 [어휘 필터 생성](vocabulary-filter-create.md) 섹션을 참조하세요. 사용자 지정 어휘 필터를 적용하는 방법을 알아보려면 [사용자 지정 어휘 필터 사용](vocabulary-filter-using.md) 섹션을 참조하세요.

**참고**  
Amazon Transcribe는 인종적으로 민감한 용어를 자동으로 마스킹하지만 [AWS 기술 지원 부서](https://aws.amazon.com/contact-us/)에 문의하여 이 기본 필터를 사용하지 않도록 설정할 수 있습니다.

어휘 필터링에 대한 비디오 시연은 다음을 참조하세요.

[![AWS Videos](http://img.youtube.com/vi/https://www.youtube.com/embed/TcpSqbr0FnI/0.jpg)](http://www.youtube.com/watch?v=https://www.youtube.com/embed/TcpSqbr0FnI)


**어휘 필터링과 관련된 API 작업**  
 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteVocabularyFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteVocabularyFilter.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetVocabularyFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetVocabularyFilter.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListVocabularyFilters.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListVocabularyFilters.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UpdateVocabularyFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UpdateVocabularyFilter.html) 

# 어휘 필터 생성
<a name="vocabulary-filter-create"></a>

사용자 지정 어휘 필터를 생성할 수 있는 두 가지 옵션이 있습니다.

1. 줄로 구분된 단어 목록을 UTF-8 인코딩의 일반 텍스트 파일로 저장합니다.
   + 이 접근 방식은 AWS Management Console, AWS CLI, 또는 AWS SDK에서 사용할 수 있습니다.
   + AWS Management Console을 사용하는 경우 사용자 지정 어휘 파일의 로컬 경로나 Amazon S3 URI를 제공할 수 있습니다.
   + AWS CLI 또는 AWS SDK를 사용하는 경우 사용자 지정 어휘 파일을 Amazon S3 버킷에 업로드하고 요청에 Amazon S3 URI를 포함해야 합니다.

1. API 요청에 쉼표로 구분된 단어 목록을 직접 포함합니다.
   + 이 접근 방식은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html#transcribe-CreateVocabularyFilter-request-Words](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html#transcribe-CreateVocabularyFilter-request-Words) 파라미터를 통해 AWS CLI 또는 AWS SDK에서 사용할 수 있습니다.

각 방법의 예는 [사용자 지정 어휘 필터 생성](#vocabulary-filtering-create-examples) 섹션을 참조하세요.

사용자 지정 어휘 필터를 생성할 때 참고할 사항:
+ 단어는 대/소문자를 구분하지 않습니다 예를 들어, "curse"와 "CURSE"는 동일한 단어로 취급합니다.
+ 정확히 일치하는 단어만 필터링합니다. 예를 들어 필터에 "swear"가 포함되어 있지만 미디어에 "swears" 또는 "swearing"이라는 단어가 포함된 경우 이러한 단어는 필터링하지 않습니다. "swear" 인스턴스만 필터링합니다. 따라서 필터링하려는 단어의 모든 변형을 포함해야 합니다.
+ 다른 단어에 포함된 단어에는 필터가 적용되지 않습니다. 예를 들어, 사용자 지정 어휘 필터에 "marine"이 포함되지만 "submarine"은 포함되지 않은 경우 트랜스크립션에서 "submarine"이 변경되지 않습니다.
+ 각 항목은 공백 없이 한 단어만 포함할 수 있습니다.
+ 사용자 지정 어휘 필터를 텍스트 파일로 저장하는 경우 UTF-8 인코딩의 일반 텍스트 형식이어야 합니다.
+ 사용자 지정 어휘 필터는 AWS 계정당 최대 100개까지 사용할 수 있으며 각 필터의 최대 용량은 50Kb일 수 있습니다.
+ 해당 언어에 지원되는 문자만 사용할 수 있습니다. 자세한 내용은 해당 언어의 [문자 집합](charsets.md)을 참조하세요.

## 사용자 지정 어휘 필터 생성
<a name="vocabulary-filtering-create-examples"></a>

Amazon Transcribe에서 사용할 사용자 지정 어휘 필터를 처리하려면 다음 예를 참조하세요.

### AWS Management Console
<a name="vocab-filter-create-console-batch"></a>

계속하기 전에 사용자 지정 어휘 필터를 텍스트(\$1.txt) 파일로 저장하세요. 필요에 따라 파일을 Amazon S3 버킷에 업로드할 수 있습니다.

1. 에 로그인합니다..[AWS Management Console](https://console.aws.amazon.com/transcribe/)

1. 탐색 창에서 **어휘 필터링**을 선택합니다. 그러면 기존 사용자 지정 어휘 필터를 확인하거나 새 필터를 생성할 수 있는 **어휘 필터** 페이지가 열립니다.

1. **어휘 필터 생성**을 선택합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: '어휘 필터' 페이지.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/vocab-filter-create-console.png)

   그러면 **어휘 필터 생성** 페이지로 이동합니다. 새 사용자 지정 어휘 필터의 이름을 입력합니다.

   **어휘 입력 소스**에서 **파일 업로드** 또는 **S3 위치** 옵션을 선택합니다. 그런 다음 사용자 지정 어휘 파일의 위치를 지정합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: '어휘 필터 생성' 페이지.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/vocab-filter-create-console-upload.png)

1. 필요에 따라 사용자 지정 어휘 필터에 태그를 추가합니다. 모든 필드를 작성하면 페이지 하단에서 **어휘 필터 생성**을 선택합니다. 파일을 처리하는 중에 오류가 없는 경우 **어휘 필터** 페이지로 돌아갑니다.

   이제 사용자 지정 어휘 필터를 사용할 준비가 되었습니다.

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

이 예시에서는 [create-vocaary-filter](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary-filter.html) 명령을 사용하여 단어 목록을 사용 가능한 사용자 지정 어휘 필터로 처리합니다. [자세한 내용은 `CreateVocabularyFilter` 단원을 참조하세요.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html)

**옵션 1**: `words` 파라미터를 사용하여 요청에 단어 목록을 포함할 수 있습니다.

```
aws transcribe create-vocabulary-filter \ 
--vocabulary-filter-name my-first-vocabulary-filter \ 
--language-code en-US \ 
--words profane,offensive,Amazon,Transcribe
```

**옵션 2**: 단어 목록을 텍스트 파일로 저장하고 Amazon S3 버킷에 업로드한 다음 `vocabulary-filter-file-uri` 파라미터를 사용하여 요청에 파일의 URI를 포함시킬 수 있습니다.

```
aws transcribe create-vocabulary-filter \ 
--vocabulary-filter-name my-first-vocabulary-filter \ 
--language-code en-US \ 
--vocabulary-filter-file-uri s3://amzn-s3-demo-bucket/my-vocabulary-filters/my-vocabulary-filter.txt
```

다음은 [create-vocabulary-filter](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary-filter.html) 명령을 사용하는 또 다른 예 및 사용자 지정 어휘 필터를 생성하는 요청 본문입니다.

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

*my-first-vocab-filter.json* 파일에는 다음과 같은 요청 본문이 포함되어 있습니다.

**옵션 1**: `Words` 파라미터를 사용하여 요청에 단어 목록을 포함할 수 있습니다.

```
{
  "VocabularyFilterName": "my-first-vocabulary-filter",
  "LanguageCode": "en-US",
  "Words": [
        "profane","offensive","Amazon","Transcribe"
  ]
}
```

**옵션 2**: 단어 목록을 텍스트 파일로 저장하고 Amazon S3 버킷에 업로드한 다음 `VocabularyFilterFileUri` 파라미터를 사용하여 요청에 파일의 URI를 포함시킬 수 있습니다.

```
{
  "VocabularyFilterName": "my-first-vocabulary-filter",
  "LanguageCode": "en-US",
  "VocabularyFilterFileUri": "s3://amzn-s3-demo-bucket/my-vocabulary-filters/my-vocabulary-filter.txt"
}
```

**참고**  
요청에 `VocabularyFilterFileUri`를 포함하는 경우 `Words`를 사용할 수 없으며 둘 중 하나를 선택해야 합니다.

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

이 예시에서는 AWS SDK for Python (Boto3)를 통해 [create\$1vocaary\$1filter](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary_filter) 메서드를 사용하여 사용자 지정 어휘 필터를 생성합니다. [자세한 내용은 `CreateVocabularyFilter` 단원을 참조하세요.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html)

기능별, 시나리오 및 교차 서비스 예를 포함하여 AWS SDK를 사용하는 추가 예시는 [AWS SDKs를 사용한 Amazon Transcribe의 코드 예제](service_code_examples.md) 장을 참조하세요.

**옵션 1**: `Words` 파라미터를 사용하여 요청에 단어 목록을 포함할 수 있습니다.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
vocab_name = "my-first-vocabulary-filter"
response = transcribe.create_vocabulary_filter(
    LanguageCode = 'en-US',
    VocabularyFilterName = vocab_name,
    Words = [        
        'profane','offensive','Amazon','Transcribe'
    ]
)
```

**옵션 2**: 단어 목록을 텍스트 파일로 저장하고 Amazon S3 버킷에 업로드한 다음 `VocabularyFilterFileUri` 파라미터를 사용하여 요청에 파일의 URI를 포함시킬 수 있습니다.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
vocab_name = "my-first-vocabulary-filter"
response = transcribe.create_vocabulary_filter(
    LanguageCode = 'en-US',
    VocabularyFilterName = vocab_name,
    VocabularyFilterFileUri = 's3://amzn-s3-demo-bucket/my-vocabulary-filters/my-vocabulary-filter.txt'
)
```

**참고**  
요청에 `VocabularyFilterFileUri`를 포함하는 경우 `Words`를 사용할 수 없으며 둘 중 하나를 선택해야 합니다.

**참고**  
사용자 지정 어휘 필터 파일을 위한 새 Amazon S3 버킷을 만드는 경우 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabularyFilter.html) 요청을 하는 IAM 역할에 이 버킷에 액세스할 수 있는 권한이 있는지 확인합니다. 역할에 올바른 권한이 없는 경우 요청이 실패합니다. 필요에 따라 `DataAccessRoleArn` 파라미터를 포함하여 요청 내에서 IAM 역할을 지정할 수 있습니다. Amazon Transcribe의 IAM 역할 및 정책에 대한 자세한 내용은 [Amazon Transcribe 자격 증명 기반 정책 예제](security_iam_id-based-policy-examples.md)를 참조하세요.

# 사용자 지정 어휘 필터 사용
<a name="vocabulary-filter-using"></a>

사용자 지정 어휘 필터가 생성되면 트랜스크립션 요청에 포함시킬 수 있습니다. 예를 보려면 다음 섹션을 참조하세요.

요청에 포함하려는 사용자 지정 어휘 필터의 언어는 미디어에 지정한 언어 코드와 일치해야 합니다. 언어 식별을 사용하고 여러 언어 옵션을 지정하는 경우 지정된 언어당 사용자 지정 어휘 필터 하나를 포함할 수 있습니다. 사용자 지정 어휘 필터의 언어가 오디오에서 식별된 언어와 일치하지 않으면 필터가 트랜스크립션에 적용되지 않으며 경고나 오류도 없습니다.

## 배치 트랜스크립션 작업에서의 어휘 필터 사용
<a name="custom-vocabulary-using-batch"></a>

배치 트랜스크립션과 함께 사용자 지정 어휘 필터를 사용하려면 다음 예를 참조하세요.

### AWS Management Console
<a name="vocab-filter-using-console-batch"></a>

1. 에 로그인합니다..[AWS Management Console](https://console.aws.amazon.com/transcribe/)

1. 탐색 창에서 **트랜스크립션 작업**을 선택한 다음 **작업 생성**(오른쪽 상단)을 선택합니다. 그러면 **작업 세부 정보 지정** 페이지가 열립니다.  
![\[Amazon Transcribe 콘솔 스크린샷: '작업 설정 지정' 페이지.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/console-batch-job-details-1.png)

   작업 이름을 지정하고 입력 미디어를 지정합니다. 필요에 따라 다른 필드를 모두 포함하고 **다음**을 선택합니다.

1. **작업 구성** 페이지의 **콘텐츠 제거** 패널에서 **어휘 필터링**을 설정합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: '작업 구성' 페이지.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/console-batch-configure-job-vocab-filter.png)

1. 드롭다운 메뉴에서 사용자 지정 어휘 필터를 선택하고 필터링 방법을 지정합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: 어휘 필터 선택 옵션.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/console-batch-vocab-filter-method.png)

1. **작업 생성**을 선택하여 트랜스크립션 작업을 실행합니다.

### AWS CLI
<a name="vocab-filter-using-cli"></a>

이 예시에서는 [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) 명령 및 `Settings` 파라미터를 `VocabularyFilterName` 및 `VocabularyFilterMethod` 하위 파라미터와 함께 사용합니다. 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) 및 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)을(를) 참조하세요.

```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--output-bucket-name amzn-s3-demo-bucket \
--output-key my-output-files/ \
--language-code en-US \
--settings VocabularyFilterName=my-first-vocabulary-filter,VocabularyFilterMethod=mask
```

다음은 [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) 명령을 사용하는 또 다른 예 및 해당 작업과 함께 사용자 지정 어휘 필터를 포함하는 요청 본문입니다.

```
aws transcribe start-transcription-job \
--region us-west-2 \
--cli-input-json file://my-first-vocabulary-filter-job.json
```

*my-first-vocabulary-filter-job.json* 파일에는 다음과 같은 요청 본문이 포함되어 있습니다.

```
{
  "TranscriptionJobName": "my-first-transcription-job",
  "Media": {
        "MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "amzn-s3-demo-bucket",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "Settings": {
        "VocabularyFilterName": "my-first-vocabulary-filter",
        "VocabularyFilterMethod": "mask"
   }
}
```

### AWS SDK for Python (Boto3)
<a name="vocab-filter-using-python-batch"></a>

이 예에서는 AWS SDK for Python (Boto3)를 통해 [start\$1transcription\$1job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) 메서드의 `Settings` 인수를 사용하여 사용자 지정 어휘 필터를 포함합니다. 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) 및 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)을(를) 참조하세요.

기능별, 시나리오 및 교차 서비스 예를 포함하여 AWS SDK를 사용하는 추가 예시는 [AWS SDKs를 사용한 Amazon Transcribe의 코드 예제](service_code_examples.md) 장을 참조하세요.

```
from __future__ import print_function
import time
import boto3
transcribe = boto3.client('transcribe', 'us-west-2')
job_name = "my-first-transcription-job"
job_uri = "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'amzn-s3-demo-bucket',
    OutputKey = 'my-output-files/', 
    LanguageCode = 'en-US', 
    Settings = {
        'VocabularyFilterName': 'my-first-vocabulary-filter',
        'VocabularyFilterMethod': 'mask' 
   }
)

while True:
    status = transcribe.get_transcription_job(TranscriptionJobName = job_name)
    if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']:
        break
    print("Not ready yet...")
    time.sleep(5)
print(status)
```

## 스트리밍 트랜스크립션에서의 사용자 지정 어휘 필터 사용
<a name="custom-vocabulary-using-stream"></a>

스트리밍 트랜스크립션과 함께 사용자 지정 어휘 필터를 사용하려면 다음 예를 참조하세요.

### AWS Management Console
<a name="vocab-filter-using-console-stream"></a>

1. 에 로그인합니다..[AWS Management Console](https://console.aws.amazon.com/transcribe/)

1. 탐색 창에서 **실시간 트랜스크립션**을 선택합니다. **콘텐츠 제거 설정**까지 아래로 스크롤하고 최소화된 경우 이 필드를 확장합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: '실시간 트랜스크립션' 페이지.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/stream-main.png)

1. **어휘 필터링**을 켭니다. 드롭다운 메뉴에서 사용자 지정 어휘 필터를 선택하고 필터링 방법을 지정합니다.  
![\[Amazon Transcribe 콘솔 스크린샷: 확장된 '콘텐츠 제거 설정' 창.\]](http://docs.aws.amazon.com/ko_kr/transcribe/latest/dg/images/vocab-filter-stream.png)

   스트림에 적용할 기타 설정을 포함합니다.

1. 이제 스트림을 트랜스크립션할 준비가 되었습니다. **스트리밍 시작**을 선택하고 말하기 시작합니다. 구술을 끝내려면 **스트리밍 중지**를 선택합니다.

### HTTP/2 스트림
<a name="vocab-filter-using-http2"></a>

이 예에서는 사용자 지정 어휘 필터와 필터 방법이 포함된 HTTP/2 요청을 생성합니다. Amazon Transcribe로 HTTP/2 스트리밍을 사용하는 방법에 대한 자세한 내용은 [HTTP/2 스트림 설정](streaming-setting-up.md#streaming-http2)을 참조하세요. Amazon Transcribe 관련 파라미터 및 헤더에 대한 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html)을 참조하세요.

```
POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: 20220208T235959Z
Authorization: AWS4-HMAC-SHA256 Credential=access-key/20220208/us-west-2/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature=string
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000      
x-amzn-transcribe-vocabulary-filter-name: my-first-vocabulary-filter
x-amzn-transcribe-vocabulary-filter-method: mask
transfer-encoding: chunked
```

파라미터 정의는 [API 참조](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)에서 찾을 수 있으며, 모든 AWS API 작업에 공통적인 파라미터는 [공통 파라미터](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) 섹션에 나열되어 있습니다.

### WebSocket 스트림
<a name="vocab-filter-using-websocket"></a>

이 예에서는 사용자 지정 어휘 필터를 WebSocket 스트림에 적용하는 미리 서명된 URL을 만듭니다. 가독성을 높이기 위해 줄바꿈이 추가되었습니다. Amazon Transcribe로 WebSocket 스트림을 사용하는 방법에 대한 자세한 내용은 [WebSocket 스트림 설정](streaming-setting-up.md#streaming-websocket)을 참조하세요. 파라미터에 대한 자세한 내용은 [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html)을 참조하세요.

```
GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000    
&vocabulary-filter-name=my-first-vocabulary-filter
&vocabulary-filter-method=mask
```

파라미터 정의는 [API 참조](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)에서 찾을 수 있으며, 모든 AWS API 작업에 공통적인 파라미터는 [공통 파라미터](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) 섹션에 나열되어 있습니다.