

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.

# Verwenden eines benutzerdefinierten Vokabulars
<a name="custom-vocabulary-using"></a>

Sobald Sie Ihr benutzerdefiniertes Vokabular erstellt haben, können Sie es in Ihre Transkriptionsanfragen aufnehmen; Beispiele finden Sie in den folgenden Abschnitten.

Die Sprache des benutzerdefinierten Vokabulars, das Sie in Ihre Anfrage aufnehmen, muss dem Sprachcode entsprechen, den Sie für Ihre Medien angeben. Wenn die Sprachen nicht übereinstimmen, wird Ihr benutzerdefiniertes Vokabular nicht auf Ihre Transkription angewendet und es gibt keine Warnungen oder Fehler.

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

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

### AWS-Managementkonsole
<a name="vocab-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 „Jobdetails 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 unten auf der Seite **Auftrag konfigurieren** im Bereich **Anpassung** die Option **Benutzerdefiniertes Vokabular**.  
![Amazon Transcribe Konsolen-Screenshot: Die Seite „Job konfigurieren“.](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/console-batch-configure-job-vocab.png)

1. Wählen Sie Ihr benutzerdefiniertes Vokabular aus dem Dropdown-Menü.

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

### AWS CLI
<a name="vocab-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 dem `VocabularyName` Unterparameter 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 VocabularyName={{my-first-vocabulary}}
```

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 Ihr benutzerdefiniertes Vokabular für diesen Job enthält.

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

Die Datei *my-first-vocabulary-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": {
        "VocabularyName": "{{my-first-vocabulary}}"
   }
}
```

### AWS SDK für Python (Boto3)
<a name="vocab-using-python-batch"></a>

In diesem Beispiel wird mithilfe des AWS SDK für Python (Boto3) `Settings` Arguments für die Methode [start\_transcription\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job) ein benutzerdefiniertes Vokabular hinzugefügt. 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 = {
        'VocabularyName': '{{my-first-vocabulary}}' 
   }
)

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 Vokabulars in einer Streaming-Transkription
<a name="custom-vocabulary-using-stream"></a>

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

### AWS-Managementkonsole
<a name="vocab-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. Blättern Sie nach unten zu **Anpassungen** 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 **Benutzerdefiniertes Vokabular** und wählen Sie ein benutzerdefiniertes Vokabular aus dem Dropdown-Menü.  
![Amazon Transcribe Konsolen-Screenshot: der erweiterte Bereich „Anpassungen“.](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-stream2.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-using-http2"></a>

In diesem Beispiel wird eine HTTP/2-Anfrage erstellt, die Ihr benutzerdefiniertes Vokabular enthält. Weitere Informationen zur Verwendung von HTTP/2-Streaming mit finden Sie Amazon Transcribe unter. [Einrichten eines HTTP/2-Streams](streaming-setting-up.md#streaming-http2) Weitere Einzelheiten zu Parametern und Kopfzeilen, die speziell für Amazon Transcribe gelten, 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).

```
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: {{20220208}}T{{235959}}Z
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-name: {{my-first-vocabulary}}
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-Operationen gemeinsam sind, sind im Abschnitt [Allgemeine Parameter](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html) aufgeführt.

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

In diesem Beispiel wird eine vorsignierte URL erstellt, die Ihr benutzerdefiniertes Vokabular 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}}%2F{{20220208}}%2F{{us-west-2}}%2F{{transcribe}}%2Faws4_request
&X-Amz-Date={{20220208}}T{{235959}}Z
&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-name={{my-first-vocabulary}}
```

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.