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.
# Benutzerdefinierte Vokabulare
Verwenden Sie benutzerdefinierte Vokabulare, um die Transkriptionsgenauigkeit für ein bestimmtes Wort oder mehrere bestimmte Wörter zu verbessern. Dabei handelt es sich in der Regel um bereichsspezifische Begriffe wie Markennamen und Akronyme, Eigennamen und Wörter, die von Amazon Transcribe nicht korrekt wiedergegeben werden.
Benutzerdefinierte Vokabulare können mit allen unterstützten Sprachen verwendet werden. Beachten Sie, dass nur die im [Zeichensatz](charsets.md) Ihrer Sprache aufgeführten Zeichen in einem benutzerdefinierten Vokabular verwendet werden können.
**Wichtig**
Sie sind für die Integrität Ihrer eigenen Daten verantwortlich, wenn Sie Amazon Transcribe verwenden. Geben Sie keine vertraulichen Daten, personenbezogene Daten (PII) oder geschützte Gesundheitsinformationen (PHI) in ein benutzerdefiniertes Vokabular ein.
Überlegungen bei der Erstellung eines benutzerdefinierten Vokabulars:
+ Sie können bis zu 100 benutzerdefinierte Vokabeldateien pro Datei haben AWS-Konto
+ Die Größe jeder benutzerdefinierten Vokabulardatei ist auf 50 Kb begrenzt
+ Wenn Sie Ihr benutzerdefiniertes Vokabular über die API erstellen, muss Ihre Vokabulardatei im Textformat (\$1.txt) vorliegen. Wenn Sie das verwenden AWS-Managementkonsole, kann Ihre Vokabeldatei im Textformat (\$1.txt) oder im Format mit kommagetrennten Werten (\$1.csv) vorliegen.
+ Jeder Eintrag innerhalb eines benutzerdefinierten Vokabulars darf nicht länger als 256 Zeichen sein
+ Um ein benutzerdefiniertes Vokabular verwenden zu können, muss es in derselben AWS-Region Weise wie Ihre Transkription erstellt worden sein.
**Tipp**
Sie können Ihr benutzerdefiniertes Vokabular mit dem AWS-Managementkonsole testen. Sobald Ihr benutzerdefiniertes Vokabular einsatzbereit ist, melden Sie sich bei an AWS-Managementkonsole, wählen Sie **Echtzeit-Transkription**, scrollen Sie zu **Anpassungen**, schalten Sie Benutzerdefiniertes Vokabular ein und wählen Sie Ihr **benutzerdefiniertes Vokabular** aus der Dropdownliste aus. Wählen Sie dann **Streaming starten**. Sprechen Sie einige der Wörter aus Ihrem benutzerdefinierten Vokabular in Ihr Mikrofon, um zu sehen, ob sie korrekt wiedergegeben werden.
## Benutzerdefinierte Vokabulartabellen versus Listen
**Wichtig**
Benutzerdefinierte Vokabulare im Listenformat werden nicht mehr verwendet. Wenn Sie ein neues benutzerdefiniertes Vokabular erstellen, verwenden Sie das [Tabellenformat](custom-vocabulary-create-table.md).
Tabellen bieten Ihnen mehr Optionen für die Eingabe und Ausgabe von Wörtern innerhalb Ihres benutzerdefinierten Vokabulars – und mehr Kontrolle darüber. Bei Tabellen müssen Sie mehrere Kategorien angeben (Phrase and DisplayAs), sodass Sie Ihre Ausgabe fein abstimmen können.
Listen haben keine zusätzlichen Optionen, sodass Sie nur Einträge so eingeben können, wie sie in Ihrer Transkript erscheinen sollen, wobei alle Leerzeichen durch Bindestriche ersetzt werden.
Die AWS-Managementkonsole AWS CLI, und AWS SDKs alle verwenden benutzerdefinierte Vokabeltabellen auf die gleiche Weise. Listen werden für jede Methode unterschiedlich verwendet und erfordern daher möglicherweise zusätzliche Formatierungen, um erfolgreich zwischen Methoden verwendet werden zu können.
Weitere Informationen erhalten Sie unter [Erstellen eines benutzerdefinierten Vokabulars mithilfe einer Tabelle](custom-vocabulary-create-table.md) und [Erstellen eines benutzerdefinierten Vokabulars mithilfe einer Liste](custom-vocabulary-create-list.md).
Wenn Sie etwas tiefer eintauchen und erfahren möchten, wie Sie Amazon Augmented AI mit benutzerdefinierten Vokabularen verwenden können, finden Sie weitere Informationen unter:
[](http://www.youtube.com/watch?v=https://www.youtube.com/embed/65eVesNiJzY)
**API-Vorgänge speziell für benutzerdefinierte Vokabulare**
[https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_DeleteVocabulary.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_GetVocabulary.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListVocabularies.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_ListVocabularies.html), [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UpdateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_UpdateVocabulary.html)
# Erstellen eines benutzerdefinierten Vokabulars mithilfe einer Tabelle
Ein Tabellenformat ist die bevorzugte Methode zur Erstellung Ihres benutzerdefinierten Vokabulars. Vokabeltabellen müssen aus vier Spalten bestehen (Phrase, SoundsLike, IPA, and DisplayAs), die in beliebiger Reihenfolge aufgenommen werden können:
| Phrase | SoundsLike | IPA | DisplayAs |
| --- | --- | --- | --- |
| Erforderlich Jede Zeile in Ihrer Tabelle muss einen Eintrag in dieser Spalte enthalten. Verwenden Sie keine Leerzeichen in dieser Spalte. Wenn Ihr Eintrag mehrere Wörter enthält, trennen Sie jedes Wort mit einem Bindestrich (-). Zum Beispiel **Andorra-la-Vella** oder **Los-Angeles**. Bei Akronymen müssen alle ausgesprochenen Buchstaben durch einen Punkt getrennt werden. Auch der abschließende Punkt muss ausgesprochen werden. Wenn Ihr Akronym im Plural steht, müssen Sie einen Bindestrich zwischen dem Akronym und dem „s“ verwenden. Zum Beispiel ist 'CLI' **C.L.I.** (nicht**C.L.I**) und 'ABCs' ist **A.B.C.-s** (nicht**A.B.C-s**). Wenn Ihr Satz aus einem Wort und einem Akronym besteht, müssen diese beiden Bestandteile durch einen Bindestrich getrennt werden. Zum Beispiel ist „DynamoDB“ **Dynamo-D.B.**. In dieser Spalte dürfen keine Ziffern stehen; die Zahlen müssen ausgeschrieben werden. Zum Beispiel ist „VX02Q“ **V.X.-zero-two-Q.**. | `SoundsLike`wird für Custom Vocabulary nicht mehr unterstützt. Bitte lassen Sie die Spalte leer. Alle Werte in dieser Spalte werden ignoriert. Wir werden die Unterstützung für diese Spalte in future entfernen. | `IPA`wird für Custom Vocabulary nicht mehr unterstützt. Bitte lassen Sie die Spalte leer. Alle Werte in dieser Spalte werden ignoriert. Wir werden die Unterstützung für diese Spalte in future entfernen. | Optional. Zeilen in dieser Spalte können leer gelassen werden. Sie können in dieser Spalte Leerzeichen verwenden. Legt fest, wie Ihr Eintrag in Ihrer Transkriptionsausgabe aussehen soll. Zum Beispiel ist **Andorra-la-Vella** in der Spalte `Phrase` gleich **Andorra la Vella** in der Spalte `DisplayAs`. Wenn eine Zeile in dieser Spalte leer ist, Amazon Transcribe verwendet es den Inhalt der `Phrase` Spalte, um die Ausgabe zu bestimmen. Sie können in dieser Spalte Ziffern (`0-9`) verwenden. |
Das sollten Sie bei der Erstellung Ihrer Tabelle beachten:
+ Ihre Tabelle muss alle vier Spaltenüberschriften enthalten (Phrase, SoundsLike, IPA, and DisplayAs). Die `Phrase` Spalte muss in jeder Zeile einen Eintrag enthalten. Die Möglichkeit, Ausspracheeingaben über `IPA` und `SoundsLike` einzugeben, wird nicht mehr unterstützt, und Sie können die Spalte leer lassen. Alle Werte in diesen Spalten werden ignoriert.
+ Jede Spalte muss mit TAB oder Komma (,) getrennt sein. Dies gilt für jede Zeile in Ihrer benutzerdefinierten Vokabulardatei. Wenn eine Zeile leere Spalten enthält, müssen Sie trotzdem ein Trennzeichen (TAB oder Komma) für jede Spalte angeben.
+ Leerzeichen sind nur innerhalb der Spalten `IPA` und `DisplayAs` erlaubt. Verwenden Sie keine Leerzeichen zur Trennung von Spalten.
+ `IPA`und `SoundsLike` werden für Custom Vocabulary nicht mehr unterstützt. Bitte lassen Sie die Spalte leer. Alle Werte in dieser Spalte werden ignoriert. Wir werden die Unterstützung für diese Spalte in future entfernen.
+ Die Spalte `DisplayAs` unterstützt Symbole und Sonderzeichen (z. B. C\$1\$1). Alle anderen Spalten unterstützen die Zeichen, die auf der Seite mit dem [Zeichensatz](charsets.md) Ihrer Sprache aufgeführt sind.
+ Wenn Sie in der Spalte `Phrase` Zahlen angeben möchten, müssen Sie diese buchstabieren. Ziffern (`0-9`) werden nur in der Spalte `DisplayAs` unterstützt.
+ Sie müssen Ihre Tabelle als Klartextdatei (\$1.txt) im Format `LF` speichern. Wenn Sie ein anderes Format verwenden, z. B.`CRLF`, kann Ihr benutzerdefiniertes Vokabular nicht verarbeitet werden.
+ Sie müssen Ihre benutzerdefinierte Vokabeldatei in einen Amazon S3 Bucket hochladen und sie mithilfe dieser Daten verarbeiten, [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)bevor Sie sie in eine Transkriptionsanfrage aufnehmen können. Anweisungen finden Sie unter [Erstellen von benutzerdefinierten Vokabulartabellen](#custom-vocabulary-create-table-examples).
**Anmerkung**
Geben Sie Akronyme oder andere Wörter, deren Buchstaben einzeln ausgesprochen werden müssen, als einzelne, durch Punkte getrennte Buchstaben ein (**A.B.C.**). Um die Pluralform eines Akronyms wie 'ABCs' einzugeben, trennen Sie das 's' vom Akronym durch einen Bindestrich (). **A.B.C.-s** Sie können Groß- oder Kleinbuchstaben verwenden, um ein Akronym zu definieren. Akronyme werden nicht in allen Sprachen unterstützt; siehe [Unterstützte Sprachen und sprachspezifische Funktionen](supported-languages.md).
Hier ist eine Beispieltabelle für ein benutzerdefiniertes Vokabular (wobei **[TAB]** ein Tabulatorzeichen darstellt):
```
Phrase[TAB]SoundsLike[TAB]IPA[TAB]DisplayAs
Los-Angeles[TAB][TAB][TAB]Los Angeles
Eva-Maria[TAB][TAB][TAB]
A.B.C.-s[TAB][TAB][TAB]ABCs
Amazon-dot-com[TAB][TAB][TAB]Amazon.com
C.L.I.[TAB][TAB][TAB]CLI
Andorra-la-Vella[TAB][TAB][TAB]Andorra la Vella
Dynamo-D.B.[TAB][TAB][TAB]DynamoDB
V.X.-zero-two[TAB][TAB][TAB]VX02
V.X.-zero-two-Q.[TAB][TAB][TAB]VX02Q
```
Zur Verdeutlichung sehen Sie hier die gleiche Tabelle mit ausgerichteten Spalten. Fügen Sie in Ihrer benutzerdefinierten Vokabulartabelle**keine** Leerzeichen zwischen den Spalten ein; Ihre Tabelle sollte wie im vorangegangenen Beispiel schief aussehen.
```
Phrase [TAB]SoundsLike [TAB]IPA [TAB]DisplayAs
Los-Angeles [TAB] [TAB] [TAB]Los Angeles
Eva-Maria [TAB] [TAB] [TAB]
A.B.C.-s [TAB] [TAB] [TAB]ABCs
amazon-dot-com [TAB] [TAB] [TAB]amazon.com
C.L.I. [TAB] [TAB] [TAB]CLI
Andorra-la-Vella[TAB] [TAB] [TAB]Andorra la Vella
Dynamo-D.B. [TAB] [TAB] [TAB]DynamoDB
V.X.-zero-two [TAB] [TAB] [TAB]VX02
V.X.-zero-two-Q.[TAB] [TAB] [TAB]VX02Q
```
## Erstellen von benutzerdefinierten Vokabulartabellen
In den folgenden Beispielen erfahren Sie Amazon Transcribe, wie Sie eine benutzerdefinierte Vokabeltabelle für die Verwendung mit bearbeiten können:
### AWS-Managementkonsole
1. Melden Sie sich an der [AWS-Managementkonsole](https://console.aws.amazon.com/transcribe/) an.
1. Wählen Sie im Navigationsbereich die Option **Benutzerdefiniertes Vokabular**. Dies öffnet die Seite **Benutzerdefiniertes Vokabular**, auf der Sie vorhandene Vokabulare ansehen oder ein neues erstellen können.
1. Wählen Sie **Vokabular erstellen**.
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Benutzerdefinierter Wortschatz“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console.png)
Sie gelangen auf die Seite **Vokabular erstellen**. Geben Sie einen Namen für Ihr neues benutzerdefiniertes Vokabular ein.
Hier haben Sie drei Möglichkeiten:
1. Laden Sie eine txt- oder csv-Datei von Ihrem Computer hoch.
Sie können entweder Ihr benutzerdefiniertes Vokabular von Grund auf neu erstellen oder eine Vorlage herunterladen, die Ihnen den Einstieg erleichtert. Ihr Vokabular wird dann automatisch im Bereich **Vokabular anzeigen und bearbeiten** ausgefüllt.
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Vokabeln erstellen und importieren“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-upload.png)
1. Importiert eine TXT- oder CSV-Datei von einem beliebigen Ort. Amazon S3
Sie können entweder Ihr benutzerdefiniertes Vokabular von Grund auf neu erstellen oder eine Vorlage herunterladen, die Ihnen den Einstieg erleichtert. Laden Sie Ihre fertige Vokabulardatei in einen Amazon S3 -Bucket hoch und geben Sie dessen URI in Ihrer Anfrage an. Ihr Vokabular wird dann automatisch im Bereich **Vokabular anzeigen und bearbeiten** ausgefüllt.
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Vokabeln erstellen und importieren“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-s3.png)
1. Erstellen Sie Ihr Vokabular manuell in der Konsole.
Blättern Sie zum Bereich **Ansicht und Vokabular bearbeiten** und wählen Sie **10 Zeilen hinzufügen**. Sie können nun Begriffe manuell eingeben.
![\[Amazon Transcribe Konsolen-Screenshot: Die Seite „Vokabeln erstellen und importieren“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-manual.png)
1. Sie können Ihr Vokabular im Bereich **Ansicht und Vokabularbearbeitung** bearbeiten. Um Änderungen vorzunehmen, klicken Sie auf den Eintrag, den Sie ändern möchten.
![\[Amazon Transcribe Konsolen-Screenshot: der Bereich „Vokabeln erstellen und bearbeiten“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-edit2.png)
Wenn Ihnen ein Fehler unterläuft, erhalten Sie eine detaillierte Fehlermeldung, sodass Sie eventuelle Probleme vor der Bearbeitung Ihres Vokabulars beheben können. Beachten Sie, dass Ihre Vokabularanfrage fehlschlägt, wenn Sie nicht alle Fehler korrigieren, bevor Sie **Vokabular erstellen** auswählen.
![\[Amazon Transcribe Konsolen-Screenshot: der Bereich „Vokabeln erstellen und bearbeiten“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-edit3.png)
Wählen Sie das Häkchen (✓), um Ihre Änderungen zu speichern, oder das „X“, um Ihre Änderungen zu verwerfen.
1. Optional können Sie Ihrem benutzerdefinierten Vokabular Tags hinzufügen. Wenn Sie alle Felder ausgefüllt haben und mit Ihrem Vokabular zufrieden sind, wählen Sie unten auf der Seite **Vokabular erstellen**. Dies bringt Sie zurück zur Seite **Benutzerdefiniertes Vokabular**, wo Sie den Status Ihres benutzerdefinierten Vokabulars einsehen können. Wenn der Status von „Ausstehend“ auf „Bereit“ wechselt, kann Ihr benutzerdefiniertes Vokabular mit einer Transkription verwendet werden.
![\[Amazon Transcribe Screenshot der Konsole: Benutzerdefiniertes Vokabular befindet sich während der Bearbeitung im Status „Ausstehend“.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-pending.png)
1. Wenn sich der Status in „Fehlgeschlagen“ ändert, wählen Sie den Namen Ihres benutzerdefinierten Vokabulars aus, um zu dessen Informationsseite zu gelangen.
![\[Amazon Transcribe Konsolen-Screenshot: Seite „Benutzerdefiniertes Vokabular“, auf der ein Vokabular als vollständig und eines als fehlerhaft angezeigt wird.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-failed.png)
Oben auf dieser Seite befindet sich ein Banner mit dem **Grund für das Scheitern**, das Auskunft darüber gibt, warum Ihr benutzerdefiniertes Vokabular nicht funktioniert hat. Korrigieren Sie den Fehler in Ihrer Textdatei und versuchen Sie es erneut.
![\[Amazon Transcribe Konsolen-Screenshot: Auf der Informationsseite des Wortschatzes wird der Grund für den Fehler angezeigt.\]](http://docs.aws.amazon.com/de_de/transcribe/latest/dg/images/vocab-create-console-failed2.png)
### AWS CLI
In diesem Beispiel wird der Befehl [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) mit einer tabellenformatierten Vokabulardatei verwendet. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).
Um ein vorhandenes benutzerdefiniertes Vokabular in einem Transkriptionsauftrag zu verwenden, geben Sie das `VocabularyName` in das [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)Feld ein, wenn Sie den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)Vorgang aufrufen, oder wählen Sie das AWS-Managementkonsole benutzerdefinierte Vokabular aus der Dropdownliste aus.
```
aws transcribe create-vocabulary \
--vocabulary-name my-first-vocabulary \
--vocabulary-file-uri s3://amzn-s3-demo-bucket/my-vocabularies/my-vocabulary-file.txt \
--language-code en-US
```
Hier ein weiteres Beispiel mit dem Befehl [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) und einem Anforderungstext, der Ihr benutzerdefiniertes Vokabular erstellt.
```
aws transcribe create-vocabulary \
--cli-input-json file://filepath/my-first-vocab-table.json
```
Die Datei *my-first-vocab-table.json* enthält den folgenden Anfragetext.
```
{
"VocabularyName": "my-first-vocabulary",
"VocabularyFileUri": "s3://amzn-s3-demo-bucket/my-vocabularies/my-vocabulary-table.txt",
"LanguageCode": "en-US"
}
```
Sobald `VocabularyState` von `PENDING` auf `READY`wechselt, ist Ihr benutzerdefiniertes Vokabular bereit für die Verwendung mit einer Transkription. Um den aktuellen Status Ihres benutzerdefinierten Vokabulars anzuzeigen, führen Sie Folgendes aus:
```
aws transcribe get-vocabulary \
--vocabulary-name my-first-vocabulary
```
### AWS SDK für Python (Boto3)
In diesem Beispiel wird mithilfe der AWS SDK für Python (Boto3) Methode [create\$1vocabulary](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary) ein benutzerdefiniertes Vokabular aus einer Tabelle erstellt. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).
Um ein vorhandenes benutzerdefiniertes Vokabular in einem Transkriptionsauftrag zu verwenden, legen Sie das `VocabularyName` in dem [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html)Feld fest, wenn Sie den [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html)Vorgang aufrufen, oder wählen Sie das AWS-Managementkonsole benutzerdefinierte Vokabular aus der Dropdownliste aus.
Weitere Beispiele für die Verwendung von 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')
vocab_name = "my-first-vocabulary"
response = transcribe.create_vocabulary(
LanguageCode = 'en-US',
VocabularyName = vocab_name,
VocabularyFileUri = 's3://amzn-s3-demo-bucket/my-vocabularies/my-vocabulary-table.txt'
)
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)
```
**Anmerkung**
Wenn Sie einen neuen Amazon S3 Bucket für Ihre benutzerdefinierten Vokabeldateien erstellen, stellen Sie sicher, dass die IAM Rolle, die die [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)Anfrage stellt, über Zugriffsberechtigungen für diesen Bucket verfügt. Wenn die Rolle nicht über die richtigen Berechtigungen verfügt, schlägt Ihre Anfrage fehl. Sie können optional eine IAM Rolle in Ihrer Anfrage angeben, indem Sie den `DataAccessRoleArn` Parameter angeben. Weitere Informationen zu IAM Rollen und Richtlinien finden Sie unter[Amazon Transcribe Beispiele für identitätsbasierte Politik](security_iam_id-based-policy-examples.md). Amazon Transcribe
# Erstellen eines benutzerdefinierten Vokabulars mithilfe einer Liste
**Wichtig**
Benutzerdefinierte Vokabulare im Listenformat sind veraltet. Wenn Sie also ein neues benutzerdefiniertes Vokabular erstellen, empfehlen wir Ihnen dringend, das [Tabellenformat](custom-vocabulary-create-table.md) zu verwenden.
Mit dem, oder können Sie benutzerdefinierte Vokabeln aus Listen erstellen. AWS-Managementkonsole AWS CLI AWS SDKs
+ **AWS-Managementkonsole**: Sie müssen eine Textdatei mit Ihrem individuellen Vokabular erstellen und hochladen. Sie können zeilengetrennte oder kommagetrennte Einträge verwenden. Beachten Sie, dass Ihre Liste als Textdatei (\$1.txt) im Format `LF` gespeichert sein muss. Wenn Sie ein anderes Format verwenden, z. B. `CRLF`, wird Ihr benutzerdefiniertes Vokabular von Amazon Transcribe nicht akzeptiert.
+ **AWS CLI**und **AWS SDKs**: Sie müssen Ihr benutzerdefiniertes Vokabular in Form von kommagetrennten Einträgen innerhalb Ihres API-Aufrufs mithilfe des Flags angeben. [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)
Wenn ein Eintrag mehrere Wörter enthält, müssen Sie jedes Wort mit einem Bindestrich trennen. Sie nehmen zum Beispiel „Los Angeles“ als **Los-Angeles** und „Andorra la Vella“ als **Andorra-la-Vella** auf.
Hier sind Beispiele für die beiden gültigen Listenformate. Siehe [Benutzerdefinierte Vokabularlisten erstellen](#custom-vocabulary-create-list-examples) für methodenspezifische Beispiele.
+ Durch Komma getrennte Einträge:
```
Los-Angeles,CLI,Eva-Maria,ABCs,Andorra-la-Vella
```
+ Zeilengetrennte Einträge:
```
Los-Angeles
CLI
Eva-Maria
ABCs
Andorra-la-Vella
```
**Wichtig**
Sie können nur Zeichen verwenden, die für Ihre Sprache unterstützt werden. Einzelheiten dazu finden Sie im [Zeichensatz](charsets.md) Ihrer Sprache.
Benutzerdefinierte Vokabularlisten werden bei dem [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateMedicalVocabulary.html)-Vorgang nicht unterstützt. Wenn Sie ein benutzerdefiniertes medizinisches Vokabular erstellen, müssen Sie ein Tabellenformat verwenden. Anweisungen finden Sie unter [Erstellen eines benutzerdefinierten Vokabulars mithilfe einer Tabelle](custom-vocabulary-create-table.md).
## Benutzerdefinierte Vokabularlisten erstellen
In den folgenden Beispielen erfahren Sie Amazon Transcribe, wie Sie eine benutzerdefinierte Vokabelliste für die Verwendung mit bearbeiten können:
### AWS CLI
In diesem Beispiel wird der Befehl [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) mit einer als Liste formatierten benutzerdefinierten Vokabulardatei verwendet. Weitere Informationen finden Sie unter [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}
```
Hier ein weiteres Beispiel mit dem Befehl [create-vocabulary](https://docs.aws.amazon.com/cli/latest/reference/transcribe/create-vocabulary.html) und einem Anforderungstext, der Ihr benutzerdefiniertes Vokabular erstellt.
```
aws transcribe create-vocabulary \
--cli-input-json file://filepath/my-first-vocab-list.json
```
Die Datei *my-first-vocab-list.json* enthält den folgenden Anforderungstext.
```
{
"VocabularyName": "my-first-vocabulary",
"LanguageCode": "en-US",
"Phrases": [
"CLI","Eva-Maria","ABCs"
]
}
```
Sobald `VocabularyState` von `PENDING` auf `READY`wechselt, ist Ihr benutzerdefiniertes Vokabular bereit für die Verwendung mit einer Transkription. Um den aktuellen Status Ihres benutzerdefinierten Vokabulars anzuzeigen, führen Sie Folgendes aus:
```
aws transcribe get-vocabulary \
--vocabulary-name my-first-vocabulary
```
### AWS SDK für Python (Boto3)
In diesem Beispiel wird mithilfe der AWS SDK für Python (Boto3) Methode [create\$1vocabulary](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.create_vocabulary) ein benutzerdefiniertes Vokabular aus einer Liste erstellt. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html).
Weitere Beispiele für die Verwendung der AWS SDKs, einschließlich funktionsspezifischer, szenarienspezifischer und serviceü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')
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)
```
**Anmerkung**
Wenn Sie einen neuen Amazon S3 Bucket für Ihre benutzerdefinierten Vokabeldateien erstellen, stellen Sie sicher, dass die IAM Rolle, die die [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_CreateVocabulary.html)Anfrage stellt, über Zugriffsberechtigungen für diesen Bucket verfügt. Wenn die Rolle nicht über die richtigen Berechtigungen verfügt, schlägt Ihre Anfrage fehl. Sie können optional eine IAM Rolle in Ihrer Anfrage angeben, indem Sie den `DataAccessRoleArn` Parameter angeben. Weitere Informationen zu IAM Rollen und Richtlinien finden Sie unter[Amazon Transcribe Beispiele für identitätsbasierte Politik](security_iam_id-based-policy-examples.md). Amazon Transcribe
# Verwenden eines benutzerdefinierten Vokabulars
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
Beispiele für die Verwendung eines benutzerdefinierten Vokabulars mit einer Batch-Transkription finden Sie im Folgenden:
### AWS-Managementkonsole
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
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)
In diesem Beispiel wird mithilfe des AWS SDK für Python (Boto3) `Settings` Arguments für die Methode [start\$1transcription\$1job](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
Beispiele für die Verwendung eines benutzerdefinierten Vokabulars mit einer Streaming-Transkription finden Sie im Folgenden:
### AWS-Managementkonsole
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
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: 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-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
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%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-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.