使用自訂詞彙篩選器

建立自訂字彙篩選條件後，您可以將其包含在轉錄請求中；請參閱下列章節以取得範例。

您要包含在請求中的自訂詞彙篩選器的語言，必須與您為媒體指定的語言代碼相符。如果您使用語言識別並指定多種語言選項，則可以針對指定的語言包含一個自訂詞彙篩選條件。如果自訂字彙篩選器的語言與您的音訊中識別的語言不符，您的篩選條件就不會套用至您的轉錄，也不會出現警告或錯誤訊息。

在批次轉錄中使用自訂詞彙篩選

若要將自訂字彙篩選器與批次轉錄搭配使用，請參閱下列範例：

登入 AWS Management Console。
在功能窗格中，選擇「轉錄工作」，然後選取「建立工作」（右上角）。這會開啟 [指定工作詳細資訊] 頁面。

為您的工作命名並指定輸入媒體。選擇性地包含任何其他欄位，然後選擇下一步。
在 [設定工作] 頁面的 [內容移除] 面板中，開啟 [字彙篩選]。
從下拉菜單中選擇自定義詞彙過濾器，然後指定過濾方法。
選取 [建立工作] 以執行轉錄工作。

此範例使用具有和VocabularyFilterMethod子Settings參數的start-transcription-job指令VocabularyFilterName和參數。如需詳細資訊，請參閱 StartTranscriptionJob 及 Settings。


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

以下是使用start-transcription-job命令的另一個範例，以及包含該工作的自訂詞彙篩選器的要求主體。


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://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
  },
  "OutputBucketName": "DOC-EXAMPLE-BUCKET",
  "OutputKey": "my-output-files/", 
  "LanguageCode": "en-US",
  "Settings": {
        "VocabularyFilterName": "my-first-vocabulary-filter",
        "VocabularyFilterMethod": "mask"
   }
}

此範例會使AWS SDK for Python (Boto3)用包含自訂字彙篩選器，並使用啟動工作方法的Settings引數。如需詳細資訊，請參閱 StartTranscriptionJob 及 Settings。

如需使用AWS SDK 的其他範例，包括特定功能、案例和跨服務範例，請參閱本Amazon Transcribe 使用的代碼示例 AWS SDKs章。


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://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
transcribe.start_transcription_job(
    TranscriptionJobName = job_name,
    Media = {
        'MediaFileUri': job_uri
    },
    OutputBucketName = 'DOC-EXAMPLE-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)

在串流轉錄中使用自訂詞彙篩選器

若要將自訂字彙篩選器與串流轉錄搭配使用，請參閱下列範例：

登入AWS Management Console。
在瀏覽窗格中，選擇 Real-time transcription (即時轉錄)。向下捲動至「內容移除設定」，如果此欄位已最小化，請展開此欄位。
開啟 [字彙篩選]。從下拉式功能表中選擇自訂詞彙篩選條件，並指定過濾方法。

新增您要套用至串流的設定。
您現在已準備好轉錄串流。選取 [開始串流] 並開始說話。若要結束聽寫，請選取 [停止串流]。

此範例會建立 HTTP/2 請求，其中包含您的自訂詞彙篩選器和篩選方法。如需使用 HTTP/2 串流搭配使用的詳細資訊Amazon Transcribe，請參閱設定 HTTP/2 串流。如需有關特定參數和標題的更多詳細資訊Amazon Transcribe，請參閱StartStreamTranscription。


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 參考中找到參數定義；所有AWS API 作業的共用參數會列在「一般參數」區段中。

此範例會建立預先簽署的 URL，將您的自訂字彙篩選器套用至 WebSocket 串流。已加入分行符號以提高可讀性。如需搭配使用 WebSocket 串流的詳細資訊Amazon Transcribe，請參閱設定 WebSocket 串流。如需參數的詳細資訊，請參閱StartStreamTranscription。


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 參考中找到參數定義；所有AWS API 作業的共用參數會列在「一般參數」區段中。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

建立字彙篩選器

偵測有毒語音