StartMedicalTranscriptionJob

Transkribiert das Audio aus einem medizinischen Diktat oder Gespräch und wendet alle zusätzlichen Anforderungsparameter an, die Sie in Ihrer Anfrage angeben.

Zusätzlich zu vielen standardmäßigen Transkriptionsfunktionen bietet Ihnen Amazon Transcribe Medical ein solides medizinisches Vokabular und optional eine Inhaltsidentifikation, die persönliche Gesundheitsinformationen (PHI) um Kennzeichnungen erweitert. Weitere Informationen zu diesen Funktionen finden Sie unter So funktioniert Amazon Transcribe Medical.

Um eineStartMedicalTranscriptionJob Anfrage zu stellen, müssen Sie zuerst Ihre Mediendatei in einen Amazon S3 S3-Bucket hochladen. Anschließend können Sie den S3-Speicherort der Datei mithilfe desMedia Parameters angeben.

Sie müssen die folgenden Parameter in IhrerStartMedicalTranscriptionJob 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.

• MedicalTranscriptionJobName: 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.

• LanguageCode: Das muss seinen-US.

• OutputBucketName: Amazon S3 Bucket, in dem Sie Ihr Transkript speichern möchten. Wenn Sie möchten, dass Ihre Ausgabe in einem Unterordner dieses Buckets gespeichert wird, müssen Sie auch hinzufügenOutputKey.

• Specialty: Das muss seinPRIMARYCARE.

• Type: Wählen Sie aus, ob Ihr Audio eine Konversation oder ein Diktat ist.

Anforderungssyntax

{
   "ContentIdentificationType": "string",
   "KMSEncryptionContext": { 
      "string" : "string" 
   },
   "LanguageCode": "string",
   "Media": { 
      "MediaFileUri": "string",
      "RedactedMediaFileUri": "string"
   },
   "MediaFormat": "string",
   "MediaSampleRateHertz": number,
   "MedicalTranscriptionJobName": "string",
   "OutputBucketName": "string",
   "OutputEncryptionKMSKeyId": "string",
   "OutputKey": "string",
   "Settings": { 
      "ChannelIdentification": boolean,
      "MaxAlternatives": number,
      "MaxSpeakerLabels": number,
      "ShowAlternatives": boolean,
      "ShowSpeakerLabels": boolean,
      "VocabularyName": "string"
   },
   "Specialty": "string",
   "Tags": [ 
      { 
         "Key": "string",
         "Value": "string"
      }
   ],
   "Type": "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.

ContentIdentificationType

Kennzeichnet alle in Ihrem Transkript identifizierten persönlichen Gesundheitsdaten (PHI). Weitere Informationen finden Sie unter Identifizieren persönlicher Gesundheitsinformationen (PHI) in einer Transkription.

Typ: Zeichenfolge

Zulässige Werte: PHI

Required: No

KMSEncryptionContext

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 und Asymmetrische Schlüssel inAWS KMS.

Typ: Abbildung einer Zeichenfolge auf eine Zeichenfolge

Zuweisungseinträge: Maximale Anzahl von 10 Elementen.

Schlüssel-Längenbeschränkungen: Minimale Länge von 1. Höchstlänge von 2000.

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

Längenbeschränkungen des Wertes: Minimale Länge von 1. Höchstlänge von 2000.

Wertemuster:.*\S.*

Required: No

LanguageCode

Der Sprachcode, der die in der Eingabemediendatei gesprochene Sprache darstellt. US-Englisch (en-US) ist der einzige gültige Wert für medizinische Transkriptionsaufträge. Jeder andere Wert, den Sie für den Sprachcode eingeben, führt zu einemBadRequestException Fehler.

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

Media

Beschreibt den Amazon S3 S3-Speicherort der Mediendatei, die Sie in Ihrer Anfrage verwenden möchten.

Informationen zu unterstützten Medienformaten finden Sie im Abschnitt MediaFormatParameter oder Medienformate im Amazon S3 S3-Entwicklerhandbuch.

Typ: Media Objekt

Erforderlich: Ja

MediaFormat

Geben Sie das Format Ihrer Eingabemediendatei an.

Typ: Zeichenfolge

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

Required: No

MediaSampleRateHertz

Die Samplerate der Audiospur in Ihrer Eingabemediendatei in Hertz.

Wenn Sie die Stichprobenrate der Medien nicht angeben, bestimmt Amazon Transcribe Medical sie für Sie. Wenn Sie die Samplerate angeben, muss sie mit der von Amazon Transcribe Medical ermittelten Rate übereinstimmen. Wenn es eine Diskrepanz zwischen dem von Ihnen angegebenen Wert und dem erkannten Wert gibt, schlägt Ihr Job fehl. Daher wird in den meisten Fällen empfohlen, die Stichprobenrate wegzulassenMediaSampleRateHertz und Amazon Transcribe Medical bestimmen zu lassen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 16000. Maximaler Wert von 48000.

Required: No

MedicalTranscriptionJobName

Ein einzigartiger, von Ihnen ausgewählter Name für Ihren medizinischen 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.

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 ein vorhandener Job 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

OutputBucketName

Der Name des Amazon-S3-Buckets, in dem Sie Ihre medizinischen Transkriptionsdaten speichern möchten. Geben Sie nicht dasS3:// Präfix des angegebenen Buckets an.

Wenn Sie möchten, dass Ihre Ausgabe in einen Unterordner dieses Buckets verschoben wird, geben Sie sie mit demOutputKey Parameter an; akzeptiertOutputBucketName nur den Namen eines Buckets.

Wenn Sie beispielsweise möchten, dass Ihre Ausgabe darin gespeichert wirdS3://DOC-EXAMPLE-BUCKET, stellen SieOutputBucketName auf einDOC-EXAMPLE-BUCKET. Wenn Sie Ihre Ausgabe jedoch speichern möchtenS3://DOC-EXAMPLE-BUCKET/test-files/, stellen SieOutputBucketName aufDOC-EXAMPLE-BUCKET undOutputKey auf eintest-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 Management Console. Siehe auch Erforderliche Berechtigungen für IAM-Benutzerrollen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 64.

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

Erforderlich: Ja

OutputEncryptionKMSKeyId

Der KMS-Schlüssel, den Sie zum Verschlüsseln Ihrer medizinischen 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.

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

3. 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.

4. 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 anderenAWS-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.

2. 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-Schlüssel (SSE-S3) von Amazon S3 key (SSE-S3) (Amazon S3).

Wenn Sie einen KMS-Schlüssel zum Verschlüsseln Ihrer Ausgabe angeben, müssen Sie mithilfe desOutputLocation Parameters auch einen Ausgabeort angeben.

Beachten Sie, dass die Rolle, die dieStartCallAnalyticsJob Anforderung stellt, über die Berechtigung zur Verwendung des ausgewählten KMS-Schlüssels verfügen muss.

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

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 medizinischen Transkriptionsauftrag angegeben haben (MedicalTranscriptionJobName).

Hier finden Sie einige Beispiele für die Art und Weise, wie SieOutputKey:

• Wenn Sie 'DOC-EXAMPLE-BUCKET' alsOutputBucketName und 'my-transcript.json' als den angebenOutputKey, lautet Ihr Ausgabepfad für die Transkriptions3://DOC-EXAMPLE-BUCKET/my-transcript.json.

• Wenn Sie 'my-first-transcription' als dasMedicalTranscriptionJobName, 'DOC-EXAMPLE-BUCKET' als dasOutputBucketName und 'my-transcript' als das angebenOutputKey, lautet Ihr Transkriptionsausgabepfads3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json.

• Wenn Sie 'DOC-EXAMPLE-BUCKET' alsOutputBucketName und 'test-files/my-transcript.json' als den angebenOutputKey, lautet Ihr Ausgabepfad für die Transkriptions3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json.

• Wenn Sie 'my-first-transcription' als dasMedicalTranscriptionJobName, 'DOC-EXAMPLE-BUCKET' als dasOutputBucketName und 'test-files/my-transcript' als das angebenOutputKey, lautet Ihr Transkriptionsausgabepfads3://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

Geben Sie in IhrerStartMedicalTranscriptionJob Anfrage zusätzliche optionale Einstellungen an, darunter Kanalidentifikation, alternative Transkriptionen und Lautsprecherpartitionierung. Sie können das verwenden, um benutzerdefinierte Vokabeln auf Ihren Transkriptionsjob anzuwenden.

Typ: MedicalTranscriptionSetting Objekt

Required: No

Specialty

Geben Sie das vorherrschende medizinische Fachgebiet an, das in Ihren Medien vertreten ist. Für Batch-TranskriptionenPRIMARYCARE ist dies der einzig gültige Wert. Wenn Sie weitere Fachgebiete benötigen, finden Sie weitere Informationen unterStartMedicalStreamTranscription.

Typ: Zeichenfolge

Zulässige Werte: PRIMARYCARE

Erforderlich: Ja

Tags

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

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. Maximale Anzahl von 200 Elementen.

Required: No

Type

Geben Sie an, ob Ihre Eingabemedien nur eine Person enthalten (DICTATION) oder eine Konversation zwischen zwei Personen enthalten (CONVERSATION).

DICTATIONKönnte beispielsweise für einen Arzt verwendet werden, der Sprachnotizen transkribieren möchte;CONVERSATION könnte für die Transkription des Arzt-Patienten-Dialogs während des Arztbesuchs des Patienten verwendet werden.

Typ: Zeichenfolge

Zulässige Werte: CONVERSATION | DICTATION

Erforderlich: Ja

Antwortsyntax

{
   "MedicalTranscriptionJob": { 
      "CompletionTime": number,
      "ContentIdentificationType": "string",
      "CreationTime": number,
      "FailureReason": "string",
      "LanguageCode": "string",
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "MedicalTranscriptionJobName": "string",
      "Settings": { 
         "ChannelIdentification": boolean,
         "MaxAlternatives": number,
         "MaxSpeakerLabels": number,
         "ShowAlternatives": boolean,
         "ShowSpeakerLabels": boolean,
         "VocabularyName": "string"
      },
      "Specialty": "string",
      "StartTime": number,
      "Tags": [ 
         { 
            "Key": "string",
            "Value": "string"
         }
      ],
      "Transcript": { 
         "TranscriptFileUri": "string"
      },
      "TranscriptionJobStatus": "string",
      "Type": "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.

MedicalTranscriptionJob

Bietet detaillierte Informationen über den aktuellen Job bei der medizinischen Transkription, einschließlich des Jobstatus und, falls zutreffend, des Ausfallsgrunds.

Typ: MedicalTranscriptionJob Objekt

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 für die 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, lösen 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

• AWS-SDK für .NET

• AWS-SDK für C++

• AWS-SDK for Go

• AWS-SDK für Java V2

• AWSSDK für JavaScript

• AWS SDK für PHP V3

• AWS SDK für Python

• AWS SDK für Ruby V3