CreateVocabularyFilter - Transcribe
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere Informationen finden Sie unter:

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.

CreateVocabularyFilter

Erstellt einen neuen benutzerdefinierten Vokabelfilter.

Sie können benutzerdefinierte Vokabelfilter verwenden, um bestimmte Wörter aus Ihrem Transkript zu maskieren, zu löschen oder zu kennzeichnen. Benutzerdefinierte Vokabelfilter werden häufig verwendet, um Obszönitäten in Transkripten zu maskieren.

Jede Sprache hat einen Zeichensatz, der alle zulässigen Zeichen für diese bestimmte Sprache enthält. Wenn Sie Zeichen verwenden, die nicht unterstützt werden, schlägt Ihre benutzerdefinierte Vokabelfilteranfrage fehl. Unter Zeichensätze für benutzerdefinierte Vokabeln finden Sie den Zeichensatz für Ihre Sprache.

Weitere Informationen finden Sie unter Wortschatzfilterung.

Anforderungssyntax

{
   "LanguageCode": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "VocabularyFilterFileUri": "string",
   "VocabularyFilterName": "string",
   "Words": [ "string" ]
}

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

LanguageCode

Der Sprachcode, der die Sprache der Einträge in Ihrem Vokabelfilter darstellt. Jeder benutzerdefinierte Vokabelfilter darf Begriffe in nur einer Sprache enthalten.

Ein benutzerdefinierter Vokabelfilter kann nur verwendet werden, um Dateien in derselben Sprache wie der Filter zu transkribieren. Wenn Sie beispielsweise einen benutzerdefinierten Vokabelfilter mit US-Englisch (en-US) erstellen, können Sie diesen Filter nur auf Dateien anwenden, die englische Audiodateien enthalten.

Eine Liste der unterstützten Sprachen und der zugehörigen Sprachcodes finden Sie in der Tabelle Unterstützte Sprachen.

Typ: Zeichenfolge

Zulässige Werte: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

Erforderlich: Ja

Tags

Fügt einem neuen benutzerdefinierten Vokabelfilter ein oder mehrere benutzerdefinierte Tags in Form eines Schlüssel:Wert-Paares hinzu, wenn Sie diesen neuen Vokabelfilter erstellen.

Weitere Informationen über die Verwendung von Tags mit Amazon Transcribe finden Sie unter Tagging-Ressourcen.

Typ: Array von Tag-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl 200 200 200 Elemente.

Required: No

VocabularyFilterFileUri

Der Amazon S3 S3-Speicherort der Textdatei, die Ihre benutzerdefinierten Vokabelfilterbegriffe enthält. Die URI muss sich in derselbenAWS-Region wie die von Ihnen aufgerufene Ressource befinden.

Ein Beispiel für einen URI-Pfad:s3://DOC-EXAMPLE-BUCKET/my-vocab-filter-file.txt

Beachten Sie, dass Sie, wenn Sie diesVocabularyFilterFileUri in Ihrer Anfrage angeben, nicht verwendenWords können. Sie müssen das eine oder das andere wählen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Die maximale Länge von 2000.

Pattern: (s3://|http(s*)://).+

Erforderlich: Nein

VocabularyFilterName

Ein von Ihnen ausgewählter eindeutiger Name für Ihren neuen benutzerdefinierten Vokabelfilter.

Dieser Name unterscheidet zwischen Groß- und Kleinschreibung, darf keine Leerzeichen enthalten und muss innerhalb eines eindeutig seinAWS-Konto. Wenn Sie versuchen, einen neuen benutzerdefinierten Vokabelfilter mit demselben Namen wie ein vorhandener benutzerdefinierter Vokabelfilter zu erstellen, erhalten Sie eineConflictException Fehlermeldung.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^[0-9a-zA-Z._-]+

Erforderlich: Ja

Words

Verwenden Sie diesen Parameter, wenn Sie Ihren benutzerdefinierten Vokabelfilter erstellen möchten, indem Sie alle gewünschten Begriffe als kommagetrennte Werte in Ihre Anfrage aufnehmen. Die andere Möglichkeit, Ihren Vokabelfilter zu erstellen, besteht darin, Ihre Einträge in einer Textdatei zu speichern und sie in einen Amazon S3 S3-Bucket hochzuladen. Geben Sie dann den Speicherort Ihrer Datei mithilfe desVocabularyFilterFileUri Parameters an.

Beachten Sie, dass Sie, wenn Sie diesWords in Ihrer Anfrage angeben, nicht verwendenVocabularyFilterFileUri können. Sie müssen das eine oder das andere wählen.

Jede Sprache hat einen Zeichensatz, der alle zulässigen Zeichen für diese bestimmte Sprache enthält. Wenn Sie Zeichen verwenden, die nicht unterstützt werden, schlägt Ihre benutzerdefinierte Vokabelfilteranfrage fehl. Unter Zeichensätze für benutzerdefinierte Vokabeln finden Sie den Zeichensatz für Ihre Sprache.

Typ: Zeichenfolge-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element.

Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 256 Zeichen.

Erforderlich: Nein

Antwortsyntax

{
   "LanguageCode": "string",
   "LastModifiedTime": number,
   "VocabularyFilterName": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

LanguageCode

Der Sprachcode, den Sie für Ihren benutzerdefinierten Vokabelfilter ausgewählt haben.

Typ: Zeichenfolge

Zulässige Werte: af-ZA | ar-AE | ar-SA | da-DK | de-CH | de-DE | en-AB | en-AU | en-GB | en-IE | en-IN | en-US | en-WL | es-ES | es-US | fa-IR | fr-CA | fr-FR | he-IL | hi-IN | id-ID | it-IT | ja-JP | ko-KR | ms-MY | nl-NL | pt-BR | pt-PT | ru-RU | ta-IN | te-IN | tr-TR | zh-CN | zh-TW | th-TH | en-ZA | en-NZ | vi-VN | sv-SE

LastModifiedTime

Das Datum und die Uhrzeit, zu der Sie Ihren benutzerdefinierten Vokabelfilter erstellt haben.

Zeitstempel haben das FormatYYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC. Steht beispielsweise2022-05-04T12:32:58.761000-07:00 für 12:32 Uhr UTC-7 am 4. Mai 2022.

Typ: Zeitstempel

VocabularyFilterName

Der Name, den Sie für Ihren benutzerdefinierten Vokabelfilter gewählt haben.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 200 Zeichen.

Pattern: ^[0-9a-zA-Z._-]+

Fehler

Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.

BadRequestException

Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann vorkommen, wenn die Entität, die Sie löschen möchten, nicht existiert oder wenn sie sich in einem nicht terminalen Zustand befindet (z. B.IN PROGRESS). Weitere Informationen finden Sie im Feld „Ausnahmemeldung“.

HTTP Status Code: 400

ConflictException

Eine Ressource mit diesem Namen ist bereits vorhanden. Ressourcennamen müssen innerhalb eines --Codes eindeutig seinAWS-Konto.

HTTP Status Code: 400

InternalFailureException

Es ist ein interner Fehler aufgetreten. Überprüfen Sie die Fehlermeldung, korrigieren Sie das Problem und versuchen Sie Ihre Anfrage erneut.

HTTP Status Code: 500

LimitExceededException

Sie haben entweder zu viele Anfragen gesendet oder Ihre Eingabedatei ist zu lang. Warten Sie, bevor Sie Ihre Anfrage erneut versuchen, oder verwenden Sie eine kleinere Datei und versuchen Sie es erneut.

HTTP Status Code: 400

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: