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 Ihrer Anfrage angeben. Um eine`StartTranscriptionJob` Anfrage zu stellen, müssen Sie zuerst Ihre Mediendatei in einen Amazon S3 S3-Bucket hochladen. Anschließend können Sie den Amazon S3 S3-Speicherort der Datei mithilfe des`Media` Parameters angeben. Sie müssen die folgenden Parameter in Ihrer`StartTranscriptionJob` Anfrage angeben: + `region`: DerAWS-Region Ort, an dem Sie Ihre Anfrage stellen. Eine Liste der von Amazon TranscribeAWS-Regionen unterstützten Endpunkte und Kontingente finden Sie unter [Amazon Transcribe Transcribe-Endpunkte und Kontingente](https://docs.aws.amazon.com/general/latest/gr/transcribe.html). + `TranscriptionJobName`: Ein benutzerdefinierter Name, den Sie für Ihren Transkriptionsauftrag erstellen und der innerhalb Ihres Unternehmens einzigartig istAWS-Konto. + `Media`(`MediaFileUri`): Der Amazon S3 S3-Speicherort Ihrer Mediendatei. + Eins von`LanguageCode``IdentifyLanguage`, oder`IdentifyMultipleLanguages`: Wenn Sie die Sprache Ihrer Mediendatei kennen, geben Sie sie mit dem`LanguageCode` Parameter an. Alle gültigen Sprachcodes finden Sie in der Tabelle [Unterstützte Sprachen](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Wenn Sie die in Ihren Medien gesprochenen Sprachen nicht kennen, verwenden Sie entweder`IdentifyLanguage` oder`IdentifyMultipleLanguages` und 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}}", "RedactedMediaFileUri": "{{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 unter [Allgemeine Parameter](CommonParameters.md). Die Anforderung akzeptiert die folgenden Daten im JSON-Format. ** [ContentRedaction](#API_StartTranscriptionJob_RequestSyntax) ** Ermöglicht es, bestimmte persönlich identifizierbare Informationen (PII) in Ihrem Transkript zu redigieren oder zu kennzeichnen. Wenn Sie verwenden`ContentRedaction`, müssen Sie auch die Unterparameter angeben:`PiiEntityTypes``RedactionOutput`, und`RedactionType`. Typ: [ContentRedaction](API_ContentRedaction.md) Objekt Required: No ** [IdentifyLanguage](#API_StartTranscriptionJob_RequestSyntax) ** Aktiviert die automatische Sprachidentifikation in Ihrer Transkriptionsanfrage. Verwenden Sie diesen Parameter, wenn Ihre Mediendatei nur eine Sprache enthält. Wenn Ihre Medien mehrere Sprachen enthalten, verwenden Sie`IdentifyMultipleLanguages` stattdessen. Wenn Sie einschließen`IdentifyLanguage`, können Sie optional eine Liste von Sprachcodes hinzufügen, indem Sie den Code verwenden`LanguageOptions`, von dem Sie glauben, dass er in Ihrer Mediendatei enthalten sein könnte. Das`LanguageOptions` Einbeziehen beschränkt`IdentifyLanguage` sich auf die von Ihnen angegebenen Sprachoptionen, wodurch die Genauigkeit der Transkription verbessert werden kann. Wenn Sie ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter auf Ihre automatische Sprachidentifikationsanforderung anwenden möchten, fügen Sie dies`LanguageIdSettings` mit den entsprechenden Unterparametern (`VocabularyName``LanguageModelName`, und`VocabularyFilterName`) hinzu. Wenn Sie einschließen`LanguageIdSettings`, schließen Sie auch ein`LanguageOptions`. Beachten Sie, dass Sie Ihrer Anfrage eines von`LanguageCode``IdentifyLanguage`, oder`IdentifyMultipleLanguages` beifügen müssen. Wenn Sie mehr als einen dieser Parameter hinzufügen, schlägt Ihr Transkriptionsauftrag fehl. Typ: Boolesch Required: No ** [IdentifyMultipleLanguages](#API_StartTranscriptionJob_RequestSyntax) ** 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 Sie`IdentifyLanguage` sie stattdessen. Wenn Sie einschließen`IdentifyMultipleLanguages`, können Sie optional eine Liste von Sprachcodes hinzufügen, indem Sie den Code verwenden`LanguageOptions`, von dem Sie glauben, dass er in Ihrer Mediendatei enthalten sein könnte. Das`LanguageOptions` Einbeziehen beschränkt`IdentifyLanguage` sich auf die von Ihnen angegebenen Sprachoptionen, wodurch die Genauigkeit der Transkription verbessert werden kann. Wenn Sie ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter auf Ihre automatische Sprachidentifikationsanfrage anwenden möchten, fügen Sie dies`LanguageIdSettings` mit den entsprechenden Unterparametern (`VocabularyName`und`VocabularyFilterName`) hinzu. Wenn Sie einschließen`LanguageIdSettings`, schließen Sie auch ein`LanguageOptions`. Beachten Sie, dass Sie Ihrer Anfrage eines von`LanguageCode``IdentifyLanguage`, oder`IdentifyMultipleLanguages` beifügen müssen. Wenn Sie mehr als einen dieser Parameter hinzufügen, schlägt Ihr Transkriptionsauftrag fehl. Typ: Boolesch Required: No ** [JobExecutionSettings](#API_StartTranscriptionJob_RequestSyntax) ** Ermöglicht es zu kontrollieren, wie Ihr Transkriptionsauftrag bearbeitet wird. Derzeit besteht die einzige`JobExecutionSettings` Änderung, die Sie wählen können, darin, die Job Queueing mithilfe des`AllowDeferredExecution` Unterparameters zu aktivieren. Wenn Sie dies`JobExecutionSettings` in Ihrer Anfrage angeben, müssen Sie auch die Unterparameter angeben:`AllowDeferredExecution` und`DataAccessRoleArn`. Typ: [JobExecutionSettings](API_JobExecutionSettings.md) Objekt Required: No ** [KMSEncryptionContext](#API_StartTranscriptionJob_RequestSyntax) ** Eine Abbildung von Schlüssel/Wert-Paaren im Klartext, die als Verschlüsselungskontextpaare bezeichnet werden und eine zusätzliche Sicherheitsebene für Ihre Daten bieten. Weitere Informationen finden Sie unter [AWS KMSVerschlüsselungskontext](https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context) und [Asymmetrische Schlüssel inAWS KMS](https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html). Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge Zuweisungseinträge: Maximale Anzahl beträgt 10 Elemente. Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 2000. Schlüssel-Muster: `.*\S.*` Längenbeschränkungen des Wertes: Minimale Länge von 1. Maximale Länge beträgt 2000. Wertemuster:`.*\S.*` Required: No ** [LanguageCode](#API_StartTranscriptionJob_RequestSyntax) ** Der Sprachcode, der die in der Eingabemediendatei gesprochene Sprache darstellt. Wenn Sie sich nicht sicher sind, welche Sprache in Ihrer Mediendatei gesprochen wird, sollten Sie erwägen, die automatische Spracherkennung`IdentifyMultipleLanguages` zu verwenden`IdentifyLanguage` oder zu aktivieren. Beachten Sie, dass Sie Ihrer Anfrage eines von`LanguageCode``IdentifyLanguage`, oder`IdentifyMultipleLanguages` beifügen müssen. Wenn Sie mehr als einen dieser Parameter hinzufügen, schlägt Ihr Transkriptionsauftrag fehl. Eine Liste der unterstützten Sprachen und der zugehörigen Sprachcodes finden Sie in der Tabelle [Unterstützte Sprachen](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Um Sprache in modernem Standardarabisch (`ar-SA`) zu transkribieren, muss Ihre Mediendatei mit einer Samplerate von 16.000 Hz oder höher codiert sein. 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` Required: No ** [LanguageIdSettings](#API_StartTranscriptionJob_RequestSyntax) ** Wenn Sie in Ihrer Anfrage die automatische Sprachidentifikation verwenden und ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter anwenden möchten, fügen Sie es`LanguageIdSettings` mit den entsprechenden Unterparametern (`VocabularyName``LanguageModelName`, und`VocabularyFilterName`) hinzu. Beachten Sie, dass die mehrsprachige Identifizierung (`IdentifyMultipleLanguages`) keine benutzerdefinierten Sprachmodelle unterstützt. `LanguageIdSettings`unterstützt zwei bis fünf Sprachcodes. Jedem Sprachcode, den Sie hinzufügen, kann ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular und ein benutzerdefinierter Vokabelfilter zugeordnet sein. Die von Ihnen angegebenen Sprachcodes müssen mit den Sprachen der zugehörigen benutzerdefinierten Sprachmodelle, benutzerdefinierten Vokabeln und benutzerdefinierten Vokabelfilter übereinstimmen. Es wird empfohlen, dies`LanguageOptions` bei der Verwendung mit einzubeziehen,`LanguageIdSettings` um sicherzustellen, dass der richtige Sprachdialekt identifiziert wird. Wenn Sie beispielsweise ein benutzerdefiniertes Vokabular angeben, das in ist, Amazon Transcribe`en-US` jedoch feststellt, dass die in Ihren Medien gesprochene Sprache ist`en-AU`, wird Ihr benutzerdefiniertes Vokabular *nicht* auf Ihre Transkription angewendet. Wenn Sie`en-US` als einzigen englischen Dialekt ein`LanguageOptions` - und einbeziehen, *wird* Ihr benutzerdefinierter Wortschatz auf Ihre Transkription angewendet. Wenn Sie Ihrer Anfrage ein benutzerdefiniertes Sprachmodell hinzufügen möchten, aber **keine** automatische Sprachidentifikation verwenden möchten, verwenden Sie stattdessen den` ModelSettings ` Parameter mit dem`LanguageModelName` Unterparameter. Wenn Sie Ihrer Anfrage ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter (oder beides) hinzufügen möchten, aber **keine** automatische Sprachidentifikation verwenden möchten, verwenden Sie stattdessen den` Settings ` Parameter mit dem Unterparameter`VocabularyName` oder`VocabularyFilterName` (oder beiden). Typ: Zeichenfolge zu[LanguageIdSettings](API_LanguageIdSettings.md) Objekt-Mapping Zuweisungseinträge: Maximale Anzahl von 5 Elementen. Gültige Schlüssel: ` 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` Required: No ** [LanguageOptions](#API_StartTranscriptionJob_RequestSyntax) ** Sie können zwei oder mehr Sprachcodes angeben, die für die Sprachen stehen, die Ihrer Meinung nach in Ihren Medien vorkommen könnten. Es wird nicht empfohlen, mehr als fünf einzubeziehen. Wenn Sie sich nicht sicher sind, welche Sprachen vorhanden sind, geben Sie diesen Parameter nicht an. Wenn Sie`LanguageOptions` in Ihrer Anfrage hinzufügen, müssen Sie dies auch hinzufügen`IdentifyLanguage`. Weitere Informationen finden Sie unter [Unterstützte Sprachen](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Um Sprache in modernem Standardarabisch (`ar-SA`) zu transkribieren, muss Ihre Mediendatei mit einer Samplerate von 16.000 Hz oder höher codiert sein. Typ: Zeichenfolge-Array Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. 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` Required: No ** [Media](#API_StartTranscriptionJob_RequestSyntax) ** Beschreibt den Amazon S3 S3-Speicherort der Mediendatei, die Sie in Ihrer Anfrage verwenden möchten. Typ: [Media](API_Media.md) Objekt Erforderlich: Ja ** [MediaFormat](#API_StartTranscriptionJob_RequestSyntax) ** Geben Sie das Format Ihrer Eingabemediendatei an. Typ: Zeichenfolge Zulässige Werte:` mp3 | mp4 | wav | flac | ogg | amr | webm` Required: No ** [MediaSampleRateHertz](#API_StartTranscriptionJob_RequestSyntax) ** Die Samplerate der Audiospur in Ihrer Eingabemediendatei in Hertz. Wenn Sie keine Medien-Sample-Rate angeben, bestimmt Amazon Transcribe sie für Sie. Wenn Sie die Samplerate angeben, muss diese mit der von Amazon Transcribe erkannten Rate übereinstimmen. Wenn zwischen dem von Ihnen angegebenen Wert und dem erkannten Wert eine Diskrepanz besteht, schlägt Ihr Job fehl. In den meisten Fällen können Sie es weglassen`MediaSampleRateHertz` und Amazon Transcribe die Samplerate bestimmen lassen. Typ: Ganzzahl Gültiger Bereich: Mindestwert von 8000. Maximaler Wert beträgt 48000. Required: No ** [ModelSettings](#API_StartTranscriptionJob_RequestSyntax) ** Geben Sie das benutzerdefinierte Sprachmodell an, das Sie in Ihren Transkriptionsauftrag einbeziehen möchten. Wenn Sie dies`ModelSettings` in Ihrer Anfrage angeben, müssen Sie den`LanguageModelName` Unterparameter angeben. Weitere Informationen finden Sie unter [Benutzerdefinierte Sprachmodelle](https://docs.aws.amazon.com/transcribe/latest/dg/custom-language-models.html). Typ: [ModelSettings](API_ModelSettings.md) Objekt Required: No ** [OutputBucketName](#API_StartTranscriptionJob_RequestSyntax) ** Der Name des Amazon-S3-Buckets, in dem Sie Ihre Transkriptionsausgabe speichern möchten. Geben Sie nicht das`S3://` Präfix des angegebenen Buckets an. Wenn Sie möchten, dass Ihre Ausgabe in einen Unterordner dieses Buckets verschoben wird, geben Sie sie mit dem`OutputKey` Parameter an; akzeptiert`OutputBucketName` nur den Namen eines Buckets. Wenn Sie beispielsweise möchten, dass Ihre Ausgabe darin gespeichert wird`S3://DOC-EXAMPLE-BUCKET`, stellen Sie`OutputBucketName` auf ein`DOC-EXAMPLE-BUCKET`. Wenn Sie Ihre Ausgabe jedoch speichern möchten`S3://DOC-EXAMPLE-BUCKET/test-files/`, stellen Sie`OutputBucketName` auf`DOC-EXAMPLE-BUCKET` und`OutputKey` auf ein`test-files/`. Beachten Sie, dass Amazon Transcribe über die Berechtigung zur Verwendung des ausgewählten Speicherorts verfügen muss. Sie können die Amazon S3 S3-Berechtigungen mit dem ändern [AWS-Managementkonsole](https://console.aws.amazon.com/s3). Siehe auch [Erforderliche Berechtigungen für IAM-Benutzerrollen](https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user). Wenn Sie nichts angeben`OutputBucketName`, wird Ihr Transkript in einem vom Service verwalteten Amazon S3 S3-Bucket abgelegt und Sie erhalten eine URI für den Zugriff auf Ihr Transkript. Typ: Zeichenfolge Längenbeschränkungen: Maximale Länge beträgt 64. Pattern: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` Erforderlich: Nein ** [OutputEncryptionKMSKeyId](#API_StartTranscriptionJob_RequestSyntax) ** Der KMS-Schlüssel, den Sie zum Verschlüsseln Ihrer Transkriptionsausgabe verwenden möchten. Wenn Sie einen Schlüssel verwenden, der sich im **aktuellen** befindetAWS-Konto, können Sie Ihren KMS-Schlüssel auf eine von vier Arten angeben: 1. Verwenden Sie die KMS-Schlüssel-ID selbst. Zum Beispiel `1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Verwenden Sie einen Alias für die KMS-Schlüssel-ID. Zum Beispiel `alias/ExampleAlias`. 1. Verwenden Sie den Amazon-Ressourcennamen (ARN) für die KMS-Schlüssel-ID. Zum Beispiel `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Verwenden Sie den ARN für den Repliatschlüssel. Zum Beispiel `arn:aws:kms:region:account-ID:alias/ExampleAlias`. Wenn Sie einen Schlüssel verwenden, der sich in einem **anderen**AWS-Konto als dem aktuellen befindetAWS-Konto, können Sie Ihren KMS-Schlüssel auf eine von zwei Arten angeben: 1. Verwenden Sie den ARN für die KMS-Schlüssel-ID. Zum Beispiel `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Verwenden Sie den ARN für den Repliatschlüssel. Zum Beispiel `arn:aws:kms:region:account-ID:alias/ExampleAlias`. Wenn Sie keinen Verschlüsselungsschlüssel angeben, wird Ihre Ausgabe mit dem Amazon S3 Standardschlüssel (SSE-S3) verschlüsselt. Wenn Sie einen KMS-Schlüssel zum Verschlüsseln Ihrer Ausgabe angeben, müssen Sie mithilfe des`OutputLocation` Parameters auch einen Ausgabeort angeben. Beachten Sie, dass die[StartCallAnalyticsJob](API_StartCallAnalyticsJob.md) Berechtigung haben muss, den ausgewählten KMS-Schlüssel zu verwenden. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 2048 Zeichen. Pattern: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` Erforderlich: Nein ** [OutputKey](#API_StartTranscriptionJob_RequestSyntax) ** Verwenden Sie es in Kombination mit,`OutputBucketName` um den Ausgabeort 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`). Hier finden Sie einige Beispiele für die Art und Weise, wie Sie Folgendes verwenden können`OutputKey`: + Wenn Sie 'DOC-EXAMPLE-BUCKET' als`OutputBucketName` und 'my-transcript.json' als den angeben`OutputKey`, lautet Ihr Ausgabepfad für die Transkription`s3://DOC-EXAMPLE-BUCKET/my-transcript.json`. + Wenn Sie 'my-first-transcription' als das`TranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' als das`OutputBucketName` und 'my-transcript' als das angeben`OutputKey`, lautet Ihr Transkriptionsausgabepfad`s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json`. + Wenn Sie 'DOC-EXAMPLE-BUCKET' als`OutputBucketName` und 'test-files/my-transcript.json' als den angeben`OutputKey`, lautet Ihr Ausgabepfad für die Transkription`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json`. + Wenn Sie 'my-first-transcription' als das`TranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' als das`OutputBucketName` und 'test-files/my-transcript' als das angeben`OutputKey`, lautet Ihr Transkriptionsausgabepfad`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json`. Wenn Sie den Namen eines Amazon S3 S3-Bucket-Unterordners angeben, der nicht existiert, wird einer für Sie erstellt. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 1. Maximale Länge beträgt 1024 Zeichen. Pattern: `[a-zA-Z0-9-_.!*'()/]{1,1024}$` Erforderlich: Nein ** [Settings](#API_StartTranscriptionJob_RequestSyntax) ** Geben Sie in Ihrer[StartTranscriptionJob](#API_StartTranscriptionJob) Anfrage zusätzliche optionale Einstellungen an, darunter Kanalidentifikation, alternative Transkriptionen und Lautsprecherpartitionierung. Sie können das verwenden, um benutzerdefinierte Vokabeln und Vokabelfilter anzuwenden. Wenn Sie Ihrer Anfrage ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter (oder beides) hinzufügen möchten, aber **keine** automatische Sprachidentifikation verwenden möchten, verwenden Sie es`Settings` mit dem Unterparameter`VocabularyName` oder`VocabularyFilterName` (oder beiden). Wenn Sie für Ihre Anfrage die automatische Sprachidentifikation verwenden und ein benutzerdefiniertes Sprachmodell, ein benutzerdefiniertes Vokabular oder einen benutzerdefinierten Vokabelfilter hinzufügen möchten, verwenden Sie stattdessen den` LanguageIdSettings ` Parameter mit den`LanguageModelName``VocabularyFilterName` Unterparametern`VocabularyName` oder. Typ: [Settings](API_Settings.md) Objekt Required: No ** [Subtitles](#API_StartTranscriptionJob_RequestSyntax) ** Erzeugt Untertiteldateien für Ihre Eingabemedien. Sie können die Formate WebVTT (\*.vtt) und SubRip (\*.srt) angeben. Typ: [Subtitles](API_Subtitles.md) Objekt Required: No ** [Tags](#API_StartTranscriptionJob_RequestSyntax) ** Fügt einem neuen Transkriptionsauftrag zu dem Zeitpunkt, zu dem Sie diesen neuen Job starten, ein oder mehrere benutzerdefinierte Tags in Form eines Schlüssel:Wert-Paares hinzu. Weitere Informationen über die Verwendung von Amazon Transcribe finden Sie unter [Tagging-Ressourcen](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html). Typ: Array von [Tag](API_Tag.md)-Objekten Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl beträgt 200 Elemente. Required: No ** [TranscriptionJobName](#API_StartTranscriptionJob_RequestSyntax) ** Ein einzigartiger, von Ihnen ausgewählter Name 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 den`OutputKey` Parameter. Dieser Name unterscheidet zwischen Groß- und Kleinschreibung, darf keine Leerzeichen enthalten und muss innerhalb eines eindeutig seinAWS-Konto. Wenn Sie versuchen, einen neuen Job mit dem gleichen Namen wie einen vorhandenen zu erstellen, erhalten Sie eine`ConflictException` Fehlermeldung. Typ: Zeichenfolge Längenbeschränkungen: Minimale Länge von 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", "RedactedMediaFileUri": "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](#API_StartTranscriptionJob_ResponseSyntax) ** Bietet detaillierte Informationen über den aktuellen Transkriptionsjob, einschließlich des Jobstatus und, falls zutreffend, der Fehlerursache. Typ: [TranscriptionJob](API_TranscriptionJob.md) Objekt ## Fehler Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unter[Häufige Fehler](CommonErrors.md). ** 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 --Objekts 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: + [AWS-Befehlszeilenschnittstelle](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartTranscriptionJob) + [AWS-SDK für .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartTranscriptionJob) + [AWS-SDK für C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartTranscriptionJob) + [AWS-SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartTranscriptionJob) + [AWS-SDK für Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartTranscriptionJob) + [AWSSDK für JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartTranscriptionJob) + [AWS SDK für PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartTranscriptionJob) + [AWS SDK für Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartTranscriptionJob) + [AWS SDK für Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartTranscriptionJob)