

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Einen benutzerdefinierten Vokalbularfilter verwenden
<a name="vocabulary-filter-using"></a>

Sobald Ihr benutzerdefinierter Vokalbularfilter erstellt ist, können Sie ihn in Ihre Transkriptionsanfragen einfügen. Beispiele finden Sie in den folgenden Abschnitten.

Die Sprache des benutzerdefinierten Wortschatzfilters, den Sie in Ihre Anfrage aufnehmen, muss dem Sprachcode entsprechen, den Sie für Ihre Medien angeben. Wenn Sie die Sprachidentifikation verwenden und mehrere Sprachoptionen angeben, können Sie einen benutzerdefinierten Vokalbularfilter pro angegebener Sprache einfügen. Wenn die Sprachen Ihrer benutzerdefinierten Wortschatzfilter nicht mit der in Ihrem Audio identifizierten Sprache übereinstimmen, werden Ihre Filter nicht auf Ihre Transkription angewendet und es gibt keine Warnungen oder Fehler.

## Verwenden eines benutzerdefinierten Vokalbularfilters in einer Batch-Transkription
<a name="custom-vocabulary-using-batch"></a>

Beispiele für die Verwendung eines benutzerdefinierten Vokalbularfilters bei einer Batch-Transkription finden Sie im Folgenden:

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

1. Melden Sie sich an der [AWS-Managementkonsole](https://console.aws.amazon.com/transcribe/) an.

1. Wählen Sie im Navigationsbereich **Transkriptionsaufträge** und dann **Auftrag erstellen** (oben rechts). Dies öffnet die Seite **Auftragsdetails angeben**.  
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Jobeinstellungen angeben“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/console-batch-job-details-1.png)

   Benennen Sie Ihren Auftrag und geben Sie Ihr Eingabemedium an. Fügen Sie optional weitere Felder hinzu und wählen Sie dann **Weiter**.

1. Aktivieren Sie auf der Seite **Auftrag konfigurieren** im Bereich **Inhaltsentfernung** die Option **Vokalbularfilterung**.  
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Job konfigurieren“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/console-batch-configure-job-vocab-filter.png)

1. Wählen Sie Ihren benutzerdefinierten Vokalbularfilter aus dem Dropdown-Menü und geben Sie die Filtermethode an.  
![\[Amazon Transcribe Konsolen-Screenshot: Optionen zur Auswahl des Vokabelfilters.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/console-batch-vocab-filter-method.png)

1. Wählen Sie **Auftrag erstellen**, um Ihren Transkriptionsauftrag auszuführen. 

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

In diesem Beispiel werden der [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Befehl und der `Settings` Parameter mit den `VocabularyFilterMethod` Unterparametern `VocabularyFilterName` und verwendet. Weitere Informationen erhalten Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) und [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
```

Hier ist ein weiteres Beispiel, in dem der [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html)Befehl verwendet wird, und ein Anfragetext, der Ihren benutzerdefinierten Vokabelfilter für diesen Job enthält.

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

Die Datei *my-first-vocabulary-filter-job.json* enthält den folgenden Anfragetext.

```
{
  "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 für Python (Boto3)
<a name="vocab-filter-using-python-batch"></a>

[In diesem Beispiel wird ein benutzerdefinierter Vokabelfilter verwendet AWS SDK für Python (Boto3) , der das `Settings` Argument für die Methode start\$1transcription\$1job verwendet.](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) Weitere Informationen erhalten Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) und [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html).

Weitere Beispiele für die Verwendung der AWS SDKs, einschließlich funktionsspezifischer, szenarienspezifischer und dienstübergreifender Beispiele, finden Sie im Kapitel. [Codebeispiele für Amazon Transcribe mit AWS SDKs](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)
```

## Verwenden eines benutzerdefinierten Wortschatzfilters in einer Streaming-Transkription
<a name="custom-vocabulary-using-stream"></a>

Beispiele für die Verwendung eines benutzerdefinierten Vokalbularfilters mit einer Streaming-Transkription finden Sie im Folgenden:

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

1. Melden Sie sich beim [AWS-Managementkonsole](https://console.aws.amazon.com/transcribe/) an.

1. Wählen Sie im Navigationsbereich **Echtzeit-Streaming** aus. Scrollen Sie nach unten zu **Einstellungen für das Entfernen von Inhalten** und erweitern Sie dieses Feld, falls es minimiert ist.  
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Transkription in Echtzeit“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/stream-main.png)

1. Aktivieren Sie die **Vokalbularfilterung**. Wählen Sie einen benutzerdefinierten Vokalbularfilter aus dem Dropdown-Menü und geben Sie die Filtermethode an.  
![\[Amazon Transcribe Konsolen-Screenshot: Der erweiterte Bereich mit den Einstellungen für das Entfernen von Inhalten.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-filter-stream.png)

   Fügen Sie alle anderen Einstellungen hinzu, die Sie auf Ihren Stream anwenden möchten.

1. Jetzt können Sie Ihren Stream transkribieren. Wählen Sie **Streaming starten** und beginnen Sie zu sprechen. Um Ihr Diktat zu beenden, wählen Sie **Streaming beenden**.

### HTTP/2-Stream
<a name="vocab-filter-using-http2"></a>

In diesem Beispiel wird eine HTTP/2-Anfrage erstellt, die Ihren benutzerdefinierten Wortschatzfilter und Ihre Filtermethode enthält. Weitere Informationen zur Verwendung von HTTP/2-Streaming mit finden Sie unter. Amazon Transcribe[Einrichten eines HTTP/2-Streams](streaming-setting-up.md#streaming-http2) Weitere Informationen zu spezifischen Parametern und Headern finden Sie Amazon Transcribe unter. [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
```

Parameterdefinitionen finden Sie in der [API-Referenz.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) Parameter, die allen AWS API-Vorgängen gemeinsam sind, sind im Abschnitt [Allgemeine Parameter](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) aufgeführt.

### WebSocket streamen
<a name="vocab-filter-using-websocket"></a>

In diesem Beispiel wird eine vorsignierte URL erstellt, die Ihren benutzerdefinierten Vokabelfilter auf einen WebSocket Stream anwendet. Für eine bessere Lesbarkeit werden Zeilenumbrüche hinzugefügt. Weitere Informationen zur Verwendung von WebSocket Streams mit finden Sie Amazon Transcribe unter[Einen WebSocket Stream einrichten](streaming-setting-up.md#streaming-websocket). Weitere Einzelheiten zu den Parametern finden Sie unter [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
```

Parameterdefinitionen finden Sie in der [API-Referenz.](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) Parameter, die allen AWS API-Vorgängen gemeinsam sind, sind im Abschnitt [Allgemeine Parameter](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) aufgeführt.