Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
StartMedicalTranscriptionJob
Transcrit le son d'une dictée ou d'une conversation médicale et applique tous les paramètres de demande supplémentaires que vous choisissez d'inclure dans votre demande.
Outre de nombreuses fonctionnalités de transcription standard, Amazon Transcribe Medical vous fournit un vocabulaire médical robuste et, en option, une identification du contenu, qui ajoute des indicateurs aux informations médicales personnelles (PHI). Pour en savoir plus sur ces fonctionnalités, consultez la section Fonctionnement d'Amazon Transcribe Medical.
Pour faire uneStartMedicalTranscriptionJob
demande, vous devez d'abord charger votre fichier multimédia dans un compartiment Amazon S3 ; vous pouvez ensuite spécifier l'emplacement S3 du fichier à l'aide duMedia
paramètre.
Vous devez inclure les paramètres suivants dans votreStartMedicalTranscriptionJob
demande :
-
region
: L'Région AWSendroit où vous faites votre demande. Pour obtenir la liste des points de terminaison et quotasRégions AWS pris en charge par Amazon Transcribe, consultez la section Points de terminaison et quotas Amazon Transcribe. -
MedicalTranscriptionJobName
: nom personnalisé que vous créez pour votre tâche de transcription et qui est unique au sein de votreCompte AWS. -
Media
(MediaFileUri
) : emplacement Amazon S3 de votre fichier multimédia. -
LanguageCode
: Cela doit être le casen-US
. -
OutputBucketName
: Compartiment Amazon S3 dans lequel votre transcription doit être stockée. Si vous souhaitez que votre sortie soit stockée dans un sous-dossier de ce compartiment, vous devez également l'inclureOutputKey
. -
Specialty
: Cela doit être le casPRIMARYCARE
. -
Type
: choisissez si votre audio est une conversation ou une dictée.
Syntaxe de la requête
{
"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
"
}
Paramètres de demande
Pour plus d'informations sur les paramètres communs à toutes les actions, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- ContentIdentificationType
-
Encryption tous les renseignements santé personnels (PHI, PHI, PHI, PHI, PHI). Pour plus d'informations, voir Identifier les informations personnelles sur la santé (PHI) dans une transcription.
Type : String
Valeurs valides :
PHI
Obligatoire : non
- KMSEncryptionContext
-
Une carte de paires clé:valeur non secrètes en texte brut, appelées paires de contextes de chiffrement, qui fournissent un niveau de sécurité supplémentaire à vos données. Pour plus d'informations, consultez les sections Contexte deAWS KMS chiffrement et Clés asymétriques dansAWS KMS.
Type : mappage chaîne/chaîne
Entrées de mappage : Nombre maximum de 10 éléments.
Contraintes de longueur de clé : longueur minimale de 1. Longueur maximale de 2000.
Modèle de clé :
.*\S.*
Contraintes de longueur de valeur : longueur minimale de 1. Longueur maximale de 2000.
Modèle de valeur :
.*\S.*
Obligatoire : non
- LanguageCode
-
Code de langue qui représente la langue parlée dans le fichier multimédia d'entrée. L'anglais américain (
en-US
) () est la seule valeur valide pour les tâches de transcription médicale. Toute autre valeur saisie pour le code de langue génère uneBadRequestException
erreur.Type : String
Valeurs valides :
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
Obligatoire : oui
- Media
-
Décrit l'emplacement Amazon S3 du fichier multimédia que vous souhaitez utiliser dans votre demande.
Pour plus d'informations sur les formats multimédia pris en charge, consultez le MediaFormatparamètre ou la section Formats multimédia du Guide du développeur Amazon S3.
Type : objet Media
Obligatoire : oui
- MediaFormat
-
Spécifiez le format de votre fichier multimédia d'entrée.
Type : String
Valeurs valides :
mp3 | mp4 | wav | flac | ogg | amr | webm
Obligatoire : non
- MediaSampleRateHertz
-
Fréquence d'échantillonnage, en hertz, de la piste audio de votre fichier multimédia d'entrée.
Si vous ne spécifiez pas la fréquence d'échantillonnage multimédia, Amazon Transcribe Medical la détermine pour vous. Si vous spécifiez la fréquence d'échantillonnage, elle doit correspondre à la fréquence détectée par Amazon Transcribe Medical ; s'il existe une différence entre la valeur que vous spécifiez et la valeur détectée, votre tâche échoue. Par conséquent, dans la plupart des cas, il est conseillé d'omettre
MediaSampleRateHertz
et de laisser Amazon Transcribe Medical déterminer la fréquence d'échantillonnage.Type : entier
Plage valide : valeur minimum de 16 000. Valeur maximum de 48 000.
Obligatoire : non
- MedicalTranscriptionJobName
-
Un nom unique, choisi par vous, pour votre travail de transcription médicale. Le nom que vous spécifiez est également utilisé comme nom par défaut de votre fichier de sortie de transcription. Si vous souhaitez spécifier un nom différent pour votre sortie de transcription, utilisez le
OutputKey
paramètre.Ce nom distingue les majuscules des minuscules, ne peut pas contenir d'espaces et doit être unique au sein d'unCompte AWS. Si vous essayez de créer une nouvelle tâche portant le même nom qu'une tâche existante, vous obtenez une
ConflictException
erreur.Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 200.
Modèle :
^[0-9a-zA-Z._-]+
Obligatoire : oui
- OutputBucketName
-
Le nom du compartiment Amazon S3 dans lequel vous souhaitez stocker vos données relatives aux transcriptions médicales. N'incluez pas le
S3://
préfixe du compartiment spécifié.Si vous souhaitez que votre sortie soit dirigée vers un sous-dossier de ce compartiment, spécifiez-le à l'aide du
OutputKey
paramètre ;OutputBucketName
seul le nom d'un compartiment est accepté.Par exemple, si vous souhaitez que votre sortie soit enregistrée dans
S3://DOC-EXAMPLE-BUCKET
, réglez-laOutputBucketName
surDOC-EXAMPLE-BUCKET
. Toutefois, si vous souhaitez que votre sortie soit enregistréeS3://DOC-EXAMPLE-BUCKET/test-files/
,OutputBucketName
réglez-la surDOC-EXAMPLE-BUCKET
etOutputKey
surtest-files/
.Notez qu'Amazon Transcribe doit avoir l'autorisation d'utiliser l'emplacement spécifié. Vous pouvez modifier les autorisations Amazon S3 à l'aide du AWS Management Console
. Reportez-vous également à la section Autorisations requises pour les rôles d'utilisateur IAM. Type : String
Contraintes de longueur : Longueur maximale de 64.
Modèle :
[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]
Obligatoire : oui
- OutputEncryptionKMSKeyId
-
clé KMS que vous souhaitez utiliser pour chiffrer votre transcription médicale.
Si vous utilisez une clé située dans la zone actuelleCompte AWS, vous pouvez spécifier votre clé KMS de l'une des quatre manières suivantes :
-
Utilisez l'ID de clé KMS lui-même. Par exemple,
1234abcd-12ab-34cd-56ef-1234567890ab
. -
Utilisez un alias pour l'ID de clé KMS. Par exemple,
alias/ExampleAlias
. -
Utilisez Amazon Resource Name (ARN) pour l'ID de clé KMS. Par exemple,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Utilisez l'ARN pour l'alias de clé KMS. Par exemple,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Si vous utilisez une clé située dans une autreCompte AWS zone que la clé actuelleCompte AWS, vous pouvez spécifier votre clé KMS de deux manières :
-
Utilisez l'ARN pour l'ID de clé KMS. Par exemple,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Utilisez l'ARN pour l'alias de clé KMS. Par exemple,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Si vous ne spécifiez pas de clé de chiffrement, votre sortie est chiffrée à l'aide de la clé Amazon S3 (SSE-S3).
Si vous spécifiez une clé KMS pour crypter votre sortie, vous devez également spécifier un emplacement de sortie à l'aide du
OutputLocation
paramètre.Notez que le rôle qui est à l'origine de laStartCallAnalyticsJob demande doit avoir l'autorisation d'utiliser la clé KMS sélectionnée.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximale de 2048.
Modèle :
^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
Obligatoire : non
-
- OutputKey
-
Utilisez-le en combinaison avec
OutputBucketName
pour spécifier l'emplacement de sortie de votre transcription et, éventuellement, un nom unique pour votre fichier de sortie. Le nom par défaut de votre sortie de transcription est le même que celui que vous avez spécifié pour votre tâche de transcription médicale (MedicalTranscriptionJobName
).Voici quelques exemples de la façon dont vous pouvez utiliser
OutputKey
:-
Si vous spécifiez « DOC-EXAMPLE-BUCKET » comme
OutputBucketName
et « my-transcript.json » commeOutputKey
, le chemin de sortie de votre transcription ests3://DOC-EXAMPLE-BUCKET/my-transcript.json
. -
Si vous spécifiezmy-first-transcription « » comme
MedicalTranscriptionJobName
, « DOC-EXAMPLE-BUCKET » comme et « my-transcript » commeOutputKey
, le chemin de sortie de votre transcription ests3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json
.OutputBucketName
-
Si vous spécifiez « DOC-EXAMPLE-BUCKET » comme
OutputBucketName
et « test-files/my-transcript.json » commeOutputKey
, le chemin de sortie de votre transcription ests3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json
. -
Si vous spécifiezmy-first-transcription « » comme
MedicalTranscriptionJobName
, « DOC-EXAMPLE-BUCKET » comme et « test-files/my-transcript » commeOutputKey
, le chemin de sortie de votre transcription ests3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json
.OutputBucketName
Si vous spécifiez le nom d'un sous-dossier de compartiment Amazon S3 qui n'existe pas, un sous-dossier est créé pour vous.
Type : String
Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 1024.
Modèle :
[a-zA-Z0-9-_.!*'()/]{1,1024}$
Obligatoire : non
-
- Settings
-
Spécifiez des paramètres facultatifs supplémentaires dans votreStartMedicalTranscriptionJob demande, notamment l'identification des chaînes, les transcriptions alternatives et le partitionnement des haut-parleurs. Vous pouvez l'utiliser pour appliquer des vocabulaires personnalisés à votre travail de transcription.
Type : objet MedicalTranscriptionSetting
Obligatoire : non
- Specialty
-
Précisez la spécialité médicale prédominante représentée dans vos médias. Pour les transcriptions par lots,
PRIMARYCARE
c'est la seule valeur valide. Si vous avez besoin de spécialités supplémentaires, reportez-vous àStartMedicalStreamTranscription.Type : String
Valeurs valides :
PRIMARYCARE
Obligatoire : oui
- Tags
-
Ajoute une ou plusieurs balises personnalisées, chacune sous la forme d'une paire clé:valeur, à une nouvelle tâche de transcription médicale au moment où vous commencez cette nouvelle tâche.
Pour en savoir plus sur l'utilisation des balises avec Amazon Transcribe, consultez Amazon Transcribe.
Type : tableau d’objets Tag
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 200 éléments.
Obligatoire : non
- Type
-
Spécifiez si votre média d'entrée contient une seule personne (
DICTATION
) ou s'il contient une conversation entre deux personnes (CONVERSATION
).Par exemple,
DICTATION
peut être utilisé pour un professionnel de la santé souhaitant transcrire des notes vocales ;CONVERSATION
peut être utilisé pour transcrire le dialogue médecin-patient lors de la visite du patient au cabinet du patient.Type : String
Valeurs valides :
CONVERSATION | DICTATION
Obligatoire : oui
Syntaxe de la réponse
{
"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"
}
}
Eléments de réponse
Si l'action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- MedicalTranscriptionJob
-
Fournit des informations détaillées sur la tâche de transcription médicale en cours, y compris le statut de la tâche et, le cas échéant, la raison de l'échec.
Type : objet MedicalTranscriptionJob
Erreurs
Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.
- BadRequestException
-
Votre demande n'a pas passé un ou plusieurs tests de validation. Cela peut se produire lorsque l'entité que vous essayez de supprimer n'existe pas ou si elle est dans un état non terminal (par exemple
IN PROGRESS
). Pour plus d'informations, consultez le champ de message d'exception.Code d'état HTTP : 400
- ConflictException
-
Une ressource portant ce nom existe déjà. Les noms de ressource doivent être uniques dans unCompte AWS.
Code d'état HTTP : 400
- InternalFailureException
-
Une erreur interne s'est produite. Vérifiez le message d'erreur, corrigez le problème et réessayez votre demande.
Code d'état HTTP : 500
- LimitExceededException
-
Vous avez envoyé trop de demandes ou votre fichier d'entrée est trop long. Attendez avant de réessayer votre demande, ou utilisez un fichier plus petit et réessayez.
Code d'état HTTP : 400
Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :