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.
# Utilisation `StartMedicalTranscriptionJob` avec un AWS SDK ou une CLI
Les exemples de code suivants illustrent comment utiliser `StartMedicalTranscriptionJob`.
------
#### [ .NET ]
**SDK pour .NET**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3/Transcribe#code-examples).
```
///
/// Start a medical transcription job for a media file. This method returns
/// as soon as the job is started.
///
/// A unique name for the medical transcription job.
/// The URI of the media file, typically an Amazon S3 location.
/// The format of the media file.
/// Location for the output, typically an Amazon S3 location.
/// Conversation or dictation transcription type.
/// A MedicalTransactionJob instance with information on the new job.
public async Task StartMedicalTranscriptionJob(
string jobName, string mediaFileUri,
MediaFormat mediaFormat, string outputBucketName, Amazon.TranscribeService.Type transcriptionType)
{
var response = await _amazonTranscribeService.StartMedicalTranscriptionJobAsync(
new StartMedicalTranscriptionJobRequest()
{
MedicalTranscriptionJobName = jobName,
Media = new Media()
{
MediaFileUri = mediaFileUri
},
MediaFormat = mediaFormat,
LanguageCode =
LanguageCode
.EnUS, // The value must be en-US for medical transcriptions.
OutputBucketName = outputBucketName,
OutputKey =
jobName, // The value is a key used to fetch the output of the transcription.
Specialty = Specialty.PRIMARYCARE, // The value PRIMARYCARE must be set.
Type = transcriptionType
});
return response.MedicalTranscriptionJob;
}
```
+ Pour plus de détails sur l'API, reportez-vous [StartMedicalTranscriptionJob](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartMedicalTranscriptionJob)à la section *Référence des AWS SDK pour .NET API*.
------
#### [ CLI ]
**AWS CLI**
**Exemple 1 : pour transcrire une dictée médicale enregistrée sous forme de fichier audio**
L’exemple `start-medical-transcription-job` suivant transcrit un fichier audio. Vous spécifiez l’emplacement de la sortie de transcription dans le paramètre `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://myfile.json}}
```
Contenu de `myfile.json` :
```
{
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T00:35:22.256000+00:00",
"CreationTime": "2020-09-20T00:35:22.218000+00:00",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Pour plus d’informations, consultez [Présentation de la transcription par lots](https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 2 : pour transcrire un dialogue entre un médecin et son patient enregistré sous forme de fichier audio**
L’exemple `start-medical-transcription-job` suivant transcrit un fichier audio contenant un dialogue entre un médecin et son patient. Vous spécifiez l'emplacement de la sortie de transcription dans le OutputBucketName paramètre.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://mysecondfile.json}}
```
Contenu de `mysecondfile.json` :
```
{
"MedicalTranscriptionJobName": "simple-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "simple-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T23:19:49.965000+00:00",
"CreationTime": "2020-09-20T23:19:49.941000+00:00",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Pour plus d’informations, consultez [Présentation de la transcription par lots](https://docs.aws.amazon.com/transcribe/latest/dg/batch-med-transcription.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 3 : pour transcrire un fichier audio multicanal d’un dialogue entre un médecin et son patient**
L’exemple `start-medical-transcription-job` suivant transcrit le son de chaque canal du fichier audio et fusionne les transcriptions distinctes de chaque canal en une seule sortie de transcription. Vous spécifiez l’emplacement de la sortie de transcription dans le paramètre `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://mythirdfile.json}}
```
Contenu de `mythirdfile.json` :
```
{
"MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ChannelIdentification": true
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "multichannel-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-20T23:46:44.081000+00:00",
"CreationTime": "2020-09-20T23:46:44.053000+00:00",
"Settings": {
"ChannelIdentification": true
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Pour plus d’informations, consultez [Identification des canaux](https://docs.aws.amazon.com/transcribe/latest/dg/how-channel-id-med.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 4 : pour transcrire un fichier audio d’un dialogue entre un médecin et son patient et identifier les locuteurs dans la sortie de transcription**
L’exemple `start-medical-transcription-job` suivant transcrit le fichier audio et étiquette le discours de chaque locuteur dans la sortie de transcription. Vous spécifiez l’emplacement de la sortie de transcription dans le paramètre `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://myfourthfile.json}}
```
Contenu de `myfourthfile.json` :
```
{
"MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowSpeakerLabels": true,
"MaxSpeakerLabels": 2
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "speaker-id-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T18:43:37.265000+00:00",
"CreationTime": "2020-09-21T18:43:37.157000+00:00",
"Settings": {
"ShowSpeakerLabels": true,
"MaxSpeakerLabels": 2
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Pour plus d’informations, consultez [Identification des locuteurs](https://docs.aws.amazon.com/transcribe/latest/dg/diarization-med.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 5 : pour transcrire une conversation médicale enregistrée sous forme de fichier audio avec jusqu’à deux alternatives de transcription**
L’exemple `start-medical-transcription-job` suivant crée jusqu’à deux transcriptions alternatives à partir d’un seul fichier audio. Un niveau de confiance est associé à chaque transcription. Par défaut, Amazon Transcribe renvoie la transcription avec le niveau de confiance le plus élevé. Vous pouvez spécifier qu’Amazon Transcribe renvoie des transcriptions supplémentaires avec des niveaux de confiance inférieurs. Vous spécifiez l’emplacement de la sortie de transcription dans le paramètre `OutputBucketName`.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://myfifthfile.json}}
```
Contenu de `myfifthfile.json` :
```
{
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowAlternatives": true,
"MaxAlternatives": 2
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T19:09:18.199000+00:00",
"CreationTime": "2020-09-21T19:09:18.171000+00:00",
"Settings": {
"ShowAlternatives": true,
"MaxAlternatives": 2
},
"Specialty": "PRIMARYCARE",
"Type": "CONVERSATION"
}
}
```
Pour plus d’informations, consultez [Transcriptions alternatives](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 6 : pour transcrire le fichier audio d’une dictée médicale avec jusqu’à deux transcriptions alternatives**
L’exemple `start-medical-transcription-job` suivant transcrit un fichier audio et utilise un filtre de vocabulaire pour masquer les mots indésirables. Vous spécifiez l'emplacement de la sortie de transcription dans le OutputBucketName paramètre.
```
aws transcribe start-medical-transcription-job \
--cli-input-json {{file://mysixthfile.json}}
```
Contenu de `mysixthfile.json` :
```
{
"MedicalTranscriptionJobName": "alternatives-conversation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"ShowAlternatives": true,
"MaxAlternatives": 2
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "alternatives-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T21:01:14.592000+00:00",
"CreationTime": "2020-09-21T21:01:14.569000+00:00",
"Settings": {
"ShowAlternatives": true,
"MaxAlternatives": 2
},
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Pour plus d’informations, consultez [Transcriptions alternatives](https://docs.aws.amazon.com/transcribe/latest/dg/how-alternatives-med.html) dans le *Guide du développeur Amazon Transcribe*.
**Exemple 7 : pour transcrire un fichier audio d’une dictée médicale avec une précision accrue en utilisant un vocabulaire personnalisé**
L’exemple `start-medical-transcription-job` suivant transcrit un fichier audio et utilise un vocabulaire médical personnalisé que vous avez créé précédemment pour augmenter la précision de la transcription. Vous spécifiez l’emplacement de la sortie de transcription dans le paramètre `OutputBucketName`.
```
aws transcribe start-transcription-job \
--cli-input-json {{file://myseventhfile.json}}
```
Contenu de `mysixthfile.json` :
```
{
"MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
"LanguageCode": "language-code",
"Specialty": "PRIMARYCARE",
"Type": "DICTATION",
"OutputBucketName":"amzn-s3-demo-bucket",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"Settings":{
"VocabularyName": "cli-medical-vocab-1"
}
}
```
Sortie :
```
{
"MedicalTranscriptionJob": {
"MedicalTranscriptionJobName": "vocabulary-dictation-medical-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "language-code",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/your-audio-file.extension"
},
"StartTime": "2020-09-21T21:17:27.045000+00:00",
"CreationTime": "2020-09-21T21:17:27.016000+00:00",
"Settings": {
"VocabularyName": "cli-medical-vocab-1"
},
"Specialty": "PRIMARYCARE",
"Type": "DICTATION"
}
}
```
Pour plus d’informations, consultez [Glossaires médicaux personnalisés](https://docs.aws.amazon.com/transcribe/latest/dg/how-vocabulary-med.html) dans le *Guide du développeur Amazon Transcribe*.
+ Pour plus de détails sur l'API, reportez-vous [StartMedicalTranscriptionJob](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-medical-transcription-job.html)à la section *Référence des AWS CLI commandes*.
------
#### [ JavaScript ]
**SDK pour JavaScript (v3)**
Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3/example_code/transcribe#code-examples).
Créez le client.
```
import { TranscribeClient } from "@aws-sdk/client-transcribe";
// Set the AWS Region.
const REGION = "REGION"; //e.g. "us-east-1"
// Create an Amazon Transcribe service client object.
const transcribeClient = new TranscribeClient({ region: REGION });
export { transcribeClient };
```
Démarrez une tâche de transcription médicale.
```
// Import the required AWS SDK clients and commands for Node.js
import { StartMedicalTranscriptionJobCommand } from "@aws-sdk/client-transcribe";
import { transcribeClient } from "./libs/transcribeClient.js";
// Set the parameters
export const params = {
MedicalTranscriptionJobName: "MEDICAL_JOB_NAME", // Required
OutputBucketName: "OUTPUT_BUCKET_NAME", // Required
Specialty: "PRIMARYCARE", // Required. Possible values are 'PRIMARYCARE'
Type: "JOB_TYPE", // Required. Possible values are 'CONVERSATION' and 'DICTATION'
LanguageCode: "LANGUAGE_CODE", // For example, 'en-US'
MediaFormat: "SOURCE_FILE_FORMAT", // For example, 'wav'
Media: {
MediaFileUri: "SOURCE_FILE_LOCATION",
// The S3 object location of the input media file. The URI must be in the same region
// as the API endpoint that you are calling.For example,
// "https://transcribe-demo.s3-REGION.amazonaws.com/hello_world.wav"
},
};
export const run = async () => {
try {
const data = await transcribeClient.send(
new StartMedicalTranscriptionJobCommand(params),
);
console.log("Success - put", data);
return data; // For unit tests.
} catch (err) {
console.log("Error", err);
}
};
run();
```
+ Pour plus d’informations, consultez le [Guide du développeur AWS SDK pour JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v3/developer-guide/transcribe-medical-examples-section.html#transcribe-start-medical-transcription).
+ Pour plus de détails sur l'API, voir [StartMedicalTranscriptionJob](https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/transcribe/command/StartMedicalTranscriptionJobCommand)la section *Référence des AWS SDK pour JavaScript API*.
------
Pour obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultez[Utilisation de ce service avec un AWS SDK](getting-started-sdk.md#sdk-general-information-section). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.