StartTranscriptionJob - Transcribe

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.

StartTranscriptionJob

Transkribiert das Audio aus einer Mediendatei und wendet alle zusätzlichen Anforderungsparameter an, die Sie in Ihre Anfrage aufnehmen möchten.

So erstellen Sie einStartTranscriptionJobanfordern, müssen Sie zuerst Ihre Mediendatei in einen Amazon S3 S3-Bucket hochladen; Sie können dann den Amazon S3 S3-Speicherort der Datei mit derMedia-Parameter.

Sie müssen folgende Parameter in IhremStartTranscriptionJobAnfrage:

  • region: DieAWS-Regionwo Sie Ihre Anfrage stellen. Für eine ListeAWS-Regionenunterstützt mit Amazon Transcribe, sieheEndpunkte und Kontingente von Amazon Transcribeaus.

  • TranscriptionJobName: Ein benutzerdefinierter Name, den Sie für Ihren Transkriptionsjob erstellen, der in IhremAWS-Kontoaus.

  • Media(MediaFileUri): Der Amazon S3 S3-Speicherort Ihrer Mediendatei.

  • Einer vonLanguageCode,IdentifyLanguage, oderIdentifyMultipleLanguages: Wenn Sie die Sprache Ihrer Mediendatei kennen, geben Sie diese mitLanguageCode-Parameter; Sie finden alle gültigen Sprachcodes imUnterstützte Sprachentabelle. Wenn Sie die in Ihren Medien gesprochenen Sprachen nicht kennen, verwenden Sie entwederIdentifyLanguageoderIdentifyMultipleLanguagesund lassen Sie Amazon Transcribe die Sprachen für Sie identifizieren.

Anforderungssyntax

{ "ContentRedaction": { "PiiEntityTypes": [ "string" ], "RedactionOutput": "string", "RedactionType": "string" }, "IdentifyLanguage": boolean, "IdentifyMultipleLanguages": boolean, "JobExecutionSettings": { "AllowDeferredExecution": boolean, "DataAccessRoleArn": "string" }, "KMSEncryptionContext": { "string" : "string" }, "LanguageCode": "string", "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageOptions": [ "string" ], "Media": { "MediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "ModelSettings": { "LanguageModelName": "string" }, "OutputBucketName": "string", "OutputEncryptionKMSKeyId": "string", "OutputKey": "string", "Settings": { "ChannelIdentification": boolean, "MaxAlternatives": number, "MaxSpeakerLabels": number, "ShowAlternatives": boolean, "ShowSpeakerLabels": boolean, "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" }, "Subtitles": { "Formats": [ "string" ], "OutputStartIndex": number }, "Tags": [ { "Key": "string", "Value": "string" } ], "TranscriptionJobName": "string" }

Anfrageparameter

Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unterGeläufige Parameteraus.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

ContentRedaction

Ermöglicht es Ihnen, bestimmte persönlich identifizierbare Informationen (PII) in Ihrem Transkript zu schwärzen oder zu markieren. Bei Verwendung vonContentRedactionmüssen Sie auch die Unterparameter angeben:PiiEntityTypes,RedactionOutput, undRedactionTypeaus.

Typ: ContentRedaction Objekt

: Erforderlich Nein

IdentifyLanguage

Ermöglicht die automatische Sprachidentifizierung in Ihrer Transkriptionsauftragsanfrage. Verwenden Sie diesen Parameter, wenn Ihre Mediendatei nur eine Sprache enthält. Wenn Ihre Medien mehrere Sprachen enthalten, verwenden SieIdentifyMultipleLanguagesStattdessen.

Wenn Sie einschließenIdentifyLanguagekönnen Sie optional eine Liste von Sprachcodes hinzufügen, indem SieLanguageOptions, von dem Sie glauben, dass sie in Ihrer Mediendatei vorhanden sein könnte. IncludeLanguageOptionsschränkt einIdentifyLanguagenur auf die von Ihnen angegebenen Sprachoptionen, die die Transkriptionsgenauigkeit verbessern können.

Wenn Sie ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter auf Ihre Anfrage zur automatischen Sprachenidentifizierung anwenden möchten, schließen SieLanguageIdSettingsmit den relevanten Unterparametern (VocabularyName,LanguageModelName, undVocabularyFilterName) enthalten. Wenn Sie einschließenLanguageIdSettings, gehören auchLanguageOptionsaus.

Beachten Sie, dass Sie einen vonLanguageCode,IdentifyLanguage, oderIdentifyMultipleLanguagesIn Ihrer Anforderung. Wenn Sie mehr als einen dieser Parameter angeben, schlägt Ihr Transkriptionsauftrag fehl.

Type: Boolesch

: Erforderlich Nein

IdentifyMultipleLanguages

Ermöglicht die automatische mehrsprachige Identifizierung in Ihrer Transkriptionsanfrage. Verwenden Sie diesen Parameter, wenn Ihre Mediendatei mehr als eine Sprache enthält. Wenn Ihre Medien nur eine Sprache enthalten, verwenden SieIdentifyLanguageStattdessen.

Wenn Sie einschließenIdentifyMultipleLanguageskönnen Sie optional eine Liste von Sprachcodes hinzufügen, indem SieLanguageOptions, von dem Sie glauben, dass sie in Ihrer Mediendatei vorhanden sein könnte. IncludeLanguageOptionsschränkt einIdentifyLanguagenur auf die von Ihnen angegebenen Sprachoptionen, die die Transkriptionsgenauigkeit verbessern können.

Wenn Sie ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter auf Ihre Anfrage zur automatischen Sprachidentifizierung anwenden möchten, schließen SieLanguageIdSettingsmit den relevanten Unterparametern (VocabularyNameundVocabularyFilterName) enthalten. Wenn Sie einschließenLanguageIdSettings, gehören auchLanguageOptionsaus.

Beachten Sie, dass Sie einen vonLanguageCode,IdentifyLanguage, oderIdentifyMultipleLanguagesIn Ihrer Anforderung. Wenn Sie mehr als einen dieser Parameter angeben, schlägt Ihr Transkriptionsauftrag fehl.

Type: Boolesch

: Erforderlich Nein

JobExecutionSettings

Ermöglicht es Ihnen, zu steuern, wie Ihr Transkriptionsauftrag verarbeitet wird. Derzeit ist das einzigeJobExecutionSettingsÄnderung, die Sie auswählen können, aktiviert die Job-Warteschlange mitAllowDeferredExecutionUnterparameter.

Wenn Sie einschließenJobExecutionSettingsIn Ihrer Anforderung müssen Sie auch die Unterparameter angeben:AllowDeferredExecutionundDataAccessRoleArnaus.

Typ: JobExecutionSettings Objekt

: Erforderlich Nein

KMSEncryptionContext

Eine Karte von Nur-Text-, nicht geheimen Schlüssel:Wert-Paaren, bekannt als Verschlüsselungskontextpaare, die eine zusätzliche Sicherheitsebene für Ihre Daten bieten. Weitere Informationen finden Sie unterAWS KMSVerschlüsselungskontextundAsymmetrische Schlüssel inAWS KMSaus.

Type: Zeichenfolge-zu-Zeichenfolge-Zuweisung

Map-Einträge: Die maximale Anzahl beträgt 10 Elemente.

Einschränkungen für die Schlüssellänge: Mindestlänge 1. Maximale Länge beträgt 2000 Zeichen.

Schlüssel-Muster: .*\S.*

Beschränkungen für Wertlänge: Mindestlänge 1. Maximale Länge beträgt 2000 Zeichen.

Wert-Muster:.*\S.*

: Erforderlich Nein

LanguageCode

Der Sprachcode, der die in der Eingabemediendatei gesprochene Sprache darstellt.

Wenn Sie sich nicht sicher sind, welche Sprache in Ihrer Mediendatei gesprochen wird, sollten SieIdentifyLanguageoderIdentifyMultipleLanguagesum die automatische Sprachenidentifizierung zu ermöglichen.

Beachten Sie, dass Sie einen vonLanguageCode,IdentifyLanguage, oderIdentifyMultipleLanguagesIn Ihrer Anforderung. Wenn Sie mehr als einen dieser Parameter angeben, schlägt Ihr Transkriptionsauftrag fehl.

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

Anmerkung

So transkribieren Sie Sprache auf Modernes Standardarabisch (ar-SA) muss Ihre Mediendatei mit einer Abtastrate von 16.000 Hz oder höher codiert sein.

Type: String (Zeichenfolge)

Zulässige Werte: af-ZA | ar-AE | ar-SA | cy-GB | 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 | ga-IE | gd-GB | 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

: Erforderlich Nein

LanguageIdSettings

Wenn Sie in Ihrer Anfrage die automatische Sprachenidentifizierung verwenden und Sie ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter anwenden möchten, schließen SieLanguageIdSettingsmit den relevanten Unterparametern (VocabularyName,LanguageModelName, undVocabularyFilterName) enthalten. Beachten Sie, dass mehrsprachige Identifikation (IdentifyMultipleLanguages) unterstützt keine benutzerdefinierten Sprachmodelle.

LanguageIdSettingsunterstützt zwei bis fünf Sprachcodes. Jeder von Ihnen enthaltene Sprachcode kann über ein zugeordnetes benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular und einen benutzerdefinierten Vokabelfilter verfügen. Die von Ihnen angegebenen Sprachcodes müssen mit den Sprachen der zugehörigen benutzerdefinierten Sprachmodelle, benutzerdefinierten Vokabeln und benutzerdefinierten Vokabelfilter übereinstimmen.

Es wird dringend empfohlen, dass SieLanguageOptionsBei Verwendung vonLanguageIdSettingsum sicherzustellen, dass der richtige Sprachdialekt identifiziert wird. Wenn Sie beispielsweise ein benutzerdefiniertes Vokabular angeben, das sich inen-USaber Amazon Transcribe bestimmt, dass die in Ihren Medien gesprochene Spracheen-AU, dein individuelles Vokabularist nichtauf Ihre Transkription angewendet. Wenn Sie einschließenLanguageOptionsund beinhaltenen-USals einziger englischsprachiger Dialekt, Ihr benutzerdefiniertes Vokabularistauf Ihre Transkription angewendet.

Wenn Sie ein benutzerdefiniertes Sprachmodell in Ihre Anfrage aufnehmen möchten, aberdo nichtdie automatische Sprachenidentifizierung verwenden möchten, verwenden Sie stattdessen die ModelSettings Parameterprogramm mit derLanguageModelNameUnterparameter. Wenn Sie ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter (oder beides) in Ihre Anfrage aufnehmen möchten,do nichtdie automatische Sprachenidentifizierung verwenden möchten, verwenden Sie stattdessen die Settings Parameterprogramm mit derVocabularyNameoderVocabularyFilterName(oder beide) Unterparameter.

Type: Zeichenfolge nachLanguageIdSettingsObjekt-Map

Map-Einträge: Maximale Anzahl beträgt 5 Elemente.

Gültige Schlüssel: af-ZA | ar-AE | ar-SA | cy-GB | 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 | ga-IE | gd-GB | 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

: Erforderlich Nein

LanguageOptions

Sie können zwei oder mehr Sprachcodes angeben, die die Sprachen darstellen, von denen Sie glauben, dass sie in Ihren Medien vorhanden sein könnten. Es wird nicht empfohlen, mehr als fünf zu verwenden. Wenn Sie sich nicht sicher sind, welche Sprachen vorhanden sind, fügen Sie diesen Parameter nicht ein.

Wenn Sie einschließenLanguageOptionsIn Ihrer Anforderung müssen Sie auch Folgendes angebenIdentifyLanguageaus.

Weitere Informationen finden Sie unterUnterstützte Sprachenaus.

So transkribieren Sie Sprache auf Modernes Standardarabisch (ar-SA) muss Ihre Mediendatei mit einer Abtastrate von 16.000 Hz oder höher codiert sein.

Type: Zeichenfolgen-Array

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

Zulässige Werte: af-ZA | ar-AE | ar-SA | cy-GB | 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 | ga-IE | gd-GB | 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

: Erforderlich Nein

Media

Beschreibt den Amazon S3 S3-Speicherort der Mediendatei, die Sie für Ihre Anfrage verwenden möchten.

Typ: Media Objekt

: Erforderlich Ja

MediaFormat

Geben Sie das Format Ihrer Eingabemediendatei an.

Type: String (Zeichenfolge)

Zulässige Werte: mp3 | mp4 | wav | flac | ogg | amr | webm

: Erforderlich Nein

MediaSampleRateHertz

Die Abtastrate der Audiospur in Ihrer Eingabemediendatei in Hertz.

Wenn Sie die Medienabtastrate nicht angeben, bestimmt Amazon Transcribe diese für Sie. Wenn Sie die Abtastrate angeben, muss sie mit der von Amazon Transcribe erkannten Rate übereinstimmen. Wenn zwischen dem von Ihnen angegebenen Wert und dem erkannten Wert eine Nichtübereinstimmung besteht, schlägt Ihr Job fehl. Daher wird empfohlen, in den meisten Fällen wegzulassenMediaSampleRateHertzund lassen Sie Amazon Transcribe die Abtastrate bestimmen.

Type: Ganzzahl

Gültiger Bereich: Der Mindestwert ist 8000. Maximaler Wert von 48000 Zeichen.

: Erforderlich Nein

ModelSettings

Geben Sie das benutzerdefinierte Sprachmodell an, das Sie in Ihren Transkriptionsauftrag aufnehmen möchten. Wenn Sie einschließenModelSettingsIn Ihrer Anforderung müssen Sie dieLanguageModelNameUnterparameter.

Weitere Informationen finden Sie unterBenutzerdefinierte Sprachmodelleaus.

Typ: ModelSettings Objekt

: Erforderlich Nein

OutputBucketName

Der Name des Amazon S3 S3-Buckets, in dem Ihre Transkriptionsausgabe gespeichert werden soll. Beziehen Sie nicht das mit einS3://Präfix des angegebenen Buckets.

Wenn Sie möchten, dass Ihre Ausgabe in einen Unterordner dieses Buckets wechseln soll, geben Sie sie mit derOutputKeyParameterwert;OutputBucketNameakzeptiert nur den Namen eines Buckets.

Zum Beispiel, wenn Sie möchten, dass Ihre Ausgabe inS3://DOC-EXAMPLE-BUCKET, setzenOutputBucketNamezuDOC-EXAMPLE-BUCKETaus. Wenn Sie jedoch möchten, dass Ihre Ausgabe inS3://DOC-EXAMPLE-BUCKET/test-files/, setzenOutputBucketNamezuDOC-EXAMPLE-BUCKETundOutputKeyzutest-files/aus.

Beachten Sie, dass Amazon Transcribe über die Berechtigung zur Verwendung des angegebenen Speicherorts verfügen muss. Sie können Amazon S3 S3-Berechtigungen mit derAWS Management Consoleaus. Weitere Informationen finden Sie auch unterErforderliche Berechtigungen für IAM-Benutzerrollenaus.

Wenn Sie kein angebenOutputBucketNamewird Ihr Transkript in einem serviceverwalteten Amazon S3 S3-Bucket abgelegt und Sie erhalten einen URI für den Zugriff auf Ihr Transkript.

Type: String (Zeichenfolge)

Längenbeschränkungen: Höchstlänge = 64 Zeichen.

Pattern: [a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]

: Erforderlich Nein

OutputEncryptionKMSKeyId

Der KMS-Schlüssel, den Sie zum Verschlüsseln Ihrer Transkriptionsausgabe verwenden möchten.

Wenn Sie einen Schlüssel verwenden, der sich imaktuelle AWS-Kontokönnen Sie Ihren KMS-Schlüssel auf vier Arten angeben:

  1. Verwenden Sie die KMS-Schlüssel-ID selbst. Beispiel: 1234abcd-12ab-34cd-56ef-1234567890ab.

  2. Verwenden Sie einen Alias für die KMS-Schlüssel-ID. Beispiel: alias/ExampleAlias.

  3. Verwenden Sie den Amazon-Ressourcennamen (ARN) für die KMS-Schlüssel-ID. Beispiel: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

  4. Verwenden Sie den ARN für den Alias für den KMS-Schlüssel. Beispiel: arn:aws:kms:region:account-ID:alias/ExampleAlias.

Wenn Sie einen Schlüssel verwenden, der sich in einemanders AWS-Kontoals der aktuelleAWS-Kontokönnen Sie Ihren KMS-Schlüssel auf zwei Arten angeben:

  1. Verwenden Sie den ARN für die KMS-Schlüssel-ID. Beispiel: arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab.

  2. Verwenden Sie den ARN für den Alias für den KMS-Schlüssel. Beispiel: arn:aws:kms:region:account-ID:alias/ExampleAlias.

Wenn Sie keinen Verschlüsselungsschlüssel angeben, wird Ihre Ausgabe mit dem standardmäßigen Amazon S3 S3-Schlüssel (SSE-S3) verschlüsselt.

Wenn Sie einen KMS-Schlüssel zum Verschlüsseln Ihrer Ausgabe angeben, müssen Sie auch einen Ausgabespeicherort mit derOutputLocation-Parameter.

Beachten Sie, dass der BenutzerStartCallAnalyticsJob-Anforderung muss über die Berechtigung zur Verwendung des angegebenen KMS-Schlüssels verfügen.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 2048 Zeichen.

Pattern: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

: Erforderlich Nein

OutputKey

Verwenden Sie diesen Wert in Kombination mitOutputBucketNameum den Ausgabespeicherort Ihres Transkripts und optional einen eindeutigen Namen für Ihre Ausgabedatei anzugeben. Der Standardname für Ihre Transkriptionsausgabe entspricht dem Namen, den Sie für Ihren Transkriptionsauftrag angegeben haben (TranscriptionJobName) enthalten.

Hier einige Beispiele, wie Sie verwenden könnenOutputKey:

  • Wenn Sie „DOC-EXAMPLE-BUCKET“ alsOutputBucketNameund 'my-transcript.json' alsOutputKeyist Ihr Transkriptionsausgabepfads3://DOC-EXAMPLE-BUCKET/my-transcript.jsonaus.

  • Wenn Sie „meine-erste Transkription“ alsTranscriptionJobName, „DOC-BEISPIEL-BUCKET“ alsOutputBucketNameund „meine-transcript“ alsOutputKeyist Ihr Transkriptionsausgabepfads3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.jsonaus.

  • Wenn Sie „DOC-EXAMPLE-BUCKET“ alsOutputBucketNameund 'test-files/my-transcript.json' alsOutputKeyist Ihr Transkriptionsausgabepfads3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.jsonaus.

  • Wenn Sie „meine-erste Transkription“ alsTranscriptionJobName, „DOC-BEISPIEL-BUCKET“ alsOutputBucketNameund „Testdateien/meine-transcript“ alsOutputKeyist Ihr Transkriptionsausgabepfads3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.jsonaus.

Wenn Sie den Namen eines Amazon S3 S3-Bucket-Unterordners angeben, der nicht existiert, wird einer für Sie erstellt.

Type: String (Zeichenfolge)

Längenbeschränkungen: Mindestlänge 1. Maximale Länge beträgt 1024 Zeichen.

Pattern: [a-zA-Z0-9-_.!*'()/]{1,1024}$

: Erforderlich Nein

Settings

Geben Sie zusätzliche optionale Einstellungen in IhremStartTranscriptionJobAnfrage, einschließlich Kanalidentifikation, alternative Transkriptionen, Sprecherbeschriftung; ermöglicht es Ihnen, benutzerdefinierte Vokabulare und Vokabelfilter anzuwenden.

Wenn Sie ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter (oder beides) in Ihre Anfrage aufnehmen möchten,do nichtdie automatische Sprachenidentifizierung verwenden möchten, verwendenSettingsmit demVocabularyNameoderVocabularyFilterName(oder beide) Unterparameter.

Wenn Sie mit Ihrer Anfrage die automatische Sprachenidentifizierung verwenden und ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter einschließen möchten, verwenden Sie stattdessen die LanguageIdSettings Parameterprogramm mit derLanguageModelName,VocabularyNameoderVocabularyFilterNameUnterparameter.

Typ: Settings Objekt

: Erforderlich Nein

Subtitles

Erzeugt Untertiteldateien für Ihre Eingabemedien. Sie können die Formate webVTT (*.vtt) und SubRip (*.srt) angeben.

Typ: Subtitles Objekt

: Erforderlich Nein

Tags

Fügt ein oder mehrere benutzerdefinierte Tags in Form eines Schlüssel:Wert-Paares zu einem neuen Transkriptionsauftrag hinzu, wenn Sie diesen neuen Job starten.

Weitere Informationen zur Verwendung von Tags mit Amazon Transcribe finden Sie unterMarkieren von Ressourcenaus.

Type: Array vonTagObjekte

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

: Erforderlich Nein

TranscriptionJobName

Ein einzigartiger Name, der von Ihnen ausgewählt wurde, für Ihren Transkriptionsjob. Der von Ihnen angegebene Name wird auch als Standardname Ihrer Transkriptionsausgabedatei verwendet. Wenn Sie einen anderen Namen für Ihre Transkriptionsausgabe angeben möchten, verwenden Sie denOutputKey-Parameter.

Bei diesem Namen wird Groß- und Kleinschreibung beachtet, darf keine Leerzeichen enthalten und muss innerhalb einesAWS-Kontoaus. Wenn Sie versuchen, einen neuen Job mit dem gleichen Namen wie einen vorhandenen Job zu erstellen, erhalten Sie einenConflictExceptionFehler.

Type: String (Zeichenfolge)

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

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

: Erforderlich Ja

Antwortsyntax

{ "TranscriptionJob": { "CompletionTime": number, "ContentRedaction": { "PiiEntityTypes": [ "string" ], "RedactionOutput": "string", "RedactionType": "string" }, "CreationTime": number, "FailureReason": "string", "IdentifiedLanguageScore": number, "IdentifyLanguage": boolean, "IdentifyMultipleLanguages": boolean, "JobExecutionSettings": { "AllowDeferredExecution": boolean, "DataAccessRoleArn": "string" }, "LanguageCode": "string", "LanguageCodes": [ { "DurationInSeconds": number, "LanguageCode": "string" } ], "LanguageIdSettings": { "string" : { "LanguageModelName": "string", "VocabularyFilterName": "string", "VocabularyName": "string" } }, "LanguageOptions": [ "string" ], "Media": { "MediaFileUri": "string" }, "MediaFormat": "string", "MediaSampleRateHertz": number, "ModelSettings": { "LanguageModelName": "string" }, "Settings": { "ChannelIdentification": boolean, "MaxAlternatives": number, "MaxSpeakerLabels": number, "ShowAlternatives": boolean, "ShowSpeakerLabels": boolean, "VocabularyFilterMethod": "string", "VocabularyFilterName": "string", "VocabularyName": "string" }, "StartTime": number, "Subtitles": { "Formats": [ "string" ], "OutputStartIndex": number, "SubtitleFileUris": [ "string" ] }, "Tags": [ { "Key": "string", "Value": "string" } ], "Transcript": { "RedactedTranscriptFileUri": "string", "TranscriptFileUri": "string" }, "TranscriptionJobName": "string", "TranscriptionJobStatus": "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.

TranscriptionJob

Bietet detaillierte Informationen über den aktuellen Transkriptionsauftrag, einschließlich Jobstatus und gegebenenfalls Ausfallgrund.

Typ: TranscriptionJob Objekt

Fehler

Informationen zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehleraus.

BadRequestException

Ihre Anfrage hat einen oder mehrere Validierungstests nicht bestanden. Dies kann auftreten, wenn die Entität, die Sie löschen möchten, nicht existiert oder sich in einem nicht terminalen Zustand befindet (z.IN PROGRESS) enthalten. Weitere Informationen finden Sie im Feld für Ausnahmenachricht.

HTTP-Statuscode: 400

ConflictException

Eine Ressource mit diesem Namen existiert bereits. Ressourcennamen müssen innerhalb einesAWS-Kontoaus.

HTTP-Statuscode: 400

InternalFailureException

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

HTTP-Statuscode: 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-Statuscode: 400

Weitere Informationen finden Sie unter:

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