Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
StartMedicalTranscriptionJob
Trascrive l'audio di un dettato o di una conversazione medica e applica eventuali parametri di richiesta aggiuntivi che scegli di includere nella richiesta.
Oltre a molte funzioni di trascrizione standard, Amazon Transcribe Medical offre un solido vocabolario medico e, facoltativamente, l'identificazione dei contenuti, che aggiunge contrassegni alle informazioni sanitarie personali (PHI). Per ulteriori informazioni su queste funzionalità, consulta Come funziona Amazon Transcribe Medical.
Per effettuare unaStartMedicalTranscriptionJob
richiesta, devi prima caricare il tuo file multimediale in un bucket Amazon S3; puoi quindi specificare la posizione S3 del file utilizzando ilMedia
parametro.
È necessario includere i seguenti parametri nellaStartMedicalTranscriptionJob
richiesta:
-
region
: IlRegione AWS luogo in cui stai facendo la tua richiesta. Per un elenco dei dispositiviRegioni AWS supportati con Amazon Transcribe, consulta gli endpoint e le quote di Amazon Transcribe. -
MedicalTranscriptionJobName
: un nome personalizzato che crei per il tuo lavoro di trascrizione e che sia unico all'interno del tuoAccount AWS. -
Media
(MediaFileUri
): la posizione Amazon S3 del tuo file multimediale. -
LanguageCode
: Deve essere cosìen-US
. -
OutputBucketName
: il bucket Amazon S3 in cui si desidera archiviare la trascrizione. Se desideri che il tuo output sia archiviato in una sottocartella di questo bucket, devi includerlo ancheOutputKey
. -
Specialty
: Deve essere cosìPRIMARYCARE
. -
Type
: scegli se l'audio è una conversazione o un dettato.
Sintassi della richiesta
{
"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
"
}
Parametri della richiesta
Per informazioni sui parametri comuni a tutte le azioni, vedere Parametri comuni.
La richiesta accetta i seguenti dati in formato JSON.
- ContentIdentificationType
-
Etichetta tutte le informazioni sanitarie personali (PHI) identificate nella trascrizione. Per ulteriori informazioni, vedere Identificazione delle informazioni sanitarie personali (PHI) in una trascrizione.
Tipo: String
Valori validi:
PHI
Required: No
- KMSEncryptionContext
-
Una mappa di coppie chiave/valore in testo normale e non segrete, note come coppie di contesto di crittografia, che forniscono un ulteriore livello di sicurezza per i tuoi dati. Per ulteriori informazioni, vedere Contesto diAWS KMS crittografia e Chiavi asimmetriche inAWS KMS.
Tipo: mappatura stringa a stringa
Voci di mappatura: numero massimo massimo massimo massimo massimo massimo massimo di 10 elementi.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. Lunghezza massima massimo massimo massimo massimo massimo massimo massimo massimo massimo
Modello di chiave:
.*\S.*
Valore dei vincoli di lunghezza: lunghezza minima di 1. Lunghezza massima massimo massimo massimo massimo massimo massimo massimo massimo massimo
Modello di valore:
.*\S.*
Required: No
- LanguageCode
-
Il codice della lingua che rappresenta la lingua parlata nel file multimediale di input. L'inglese americano (
en-US
) è l'unico valore valido per i lavori di trascrizione medica. Qualsiasi altro valore immesso per il codice della lingua genera unBadRequestException
errore.Tipo: String
Valori validi:
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
Campo obbligatorio: sì
- Media
-
Descrive la posizione Amazon S3 del file multimediale che desideri utilizzare nella richiesta.
Per informazioni sui formati multimediali supportati, consulta il MediaFormatparametro o la sezione Formati multimediali nella Amazon S3 Developer Guide.
Tipo: Media oggetto
Campo obbligatorio: sì
- MediaFormat
-
Specifica il formato del file multimediale di input.
Tipo: String
Valori validi:
mp3 | mp4 | wav | flac | ogg | amr | webm
Required: No
- MediaSampleRateHertz
-
La frequenza di campionamento, in hertz, della traccia audio nel file multimediale di ingresso.
Se non specifichi la frequenza di campionamento multimediale, Amazon Transcribe Medical la determina automaticamente. Se specifichi la frequenza di campionamento, questa deve corrispondere alla frequenza rilevata da Amazon Transcribe Medical; se c'è una mancata corrispondenza tra il valore specificato e il valore rilevato, il lavoro ha esito negativo. Pertanto, nella maggior parte dei casi, si consiglia di omettere
MediaSampleRateHertz
e lasciare che Amazon Transcribe Medical determini la frequenza di campionamento.Tipo: integer
Intervallo valido: valore minimo di 16000. Valore massimo massimo massimo massimo massimo massimo massimo massimo massimo massimo massimo
Required: No
- MedicalTranscriptionJobName
-
Un nome univoco, scelto da te, per il tuo lavoro di trascrizione medica. Il nome specificato viene utilizzato anche come nome predefinito del file di output della trascrizione. Se desideri specificare un nome diverso per l'output della trascrizione, usa il
OutputKey
parametro.Questo nome fa distinzione tra maiuscole e minuscole, non può contenere spazi e deve essere univoco all'interno di unAccount AWS. Se si tenta di creare un nuovo lavoro con lo stesso nome di un lavoro esistente, viene visualizzato un
ConflictException
errore.Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.
Pattern:
^[0-9a-zA-Z._-]+
Campo obbligatorio: sì
- OutputBucketName
-
Il nome del bucket Amazon S3 in cui si desidera archiviare l'output della trascrizione medica. Non includere il
S3://
prefisso del bucket specificato.Se vuoi che il tuo output vada in una sottocartella di questo bucket, specificalo usando il
OutputKey
parametro; accettaOutputBucketName
solo il nome di un bucket.Ad esempio, se desideri che l'output venga archiviato in
S3://DOC-EXAMPLE-BUCKET
, impostaOutputBucketName
suDOC-EXAMPLE-BUCKET
. Tuttavia, se desideri che l'output venga archiviato inS3://DOC-EXAMPLE-BUCKET/test-files/
, impostaOutputBucketName
suDOC-EXAMPLE-BUCKET
eOutputKey
sutest-files/
.Tieni presente che Amazon Transcribe deve disporre dell'autorizzazione per utilizzare la posizione specificata. Puoi modificare le autorizzazioni di Amazon S3 utilizzando il AWS Management Console
. Vedi anche Autorizzazioni richieste per i ruoli utente IAM. Tipo: String
Limitazioni di lunghezza: lunghezza massima massimo massimo massimo massimo massimo di 64.
Pattern:
[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]
Campo obbligatorio: sì
- OutputEncryptionKMSKeyId
-
Chiave KMS che desideri utilizzare per crittografare l'output della trascrizione medica.
Se usi una chiave che si trova nella correnteAccount AWS, puoi specificare la tua chiave KMS in quattro modi:
-
Usa l'ID della chiave KMS stesso. Ad esempio,
1234abcd-12ab-34cd-56ef-1234567890ab
. -
Usa un alias per l'ID della chiave KMS. Ad esempio,
alias/ExampleAlias
. -
Utilizza l'Amazon Resource Name (ARN) per l'ID della chiave KMS. Ad esempio,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Usa l'ARN per l'alias della chiave KMS. Ad esempio,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Se usi una chiave che si trova in una posizione Account AWSdiversa da quella attualeAccount AWS, puoi specificare la tua chiave KMS in due modi:
-
Usa l'ARN per l'ID della chiave KMS. Ad esempio,
arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab
. -
Usa l'ARN per l'alias della chiave KMS. Ad esempio,
arn:aws:kms:region:account-ID:alias/ExampleAlias
.
Se non si specifica una chiave di crittografia, l'output viene crittografato con la chiave Amazon S3 (SSE-S3).
Se si specifica una chiave KMS per crittografare l'output, è necessario specificare anche una posizione di output utilizzando il
OutputLocation
parametro.Si noti che il ruolo che effettua laStartCallAnalyticsJob richiesta deve disporre dell'autorizzazione per utilizzare la chiave KMS specificata.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Modello:
^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$
Required: No
-
- OutputKey
-
Utilizzalo in combinazione con
OutputBucketName
per specificare la posizione di output della trascrizione e, facoltativamente, un nome univoco per il file di output. Il nome predefinito per l'output della trascrizione è lo stesso che hai specificato per il tuo lavoro di trascrizione medica (MedicalTranscriptionJobName
).Di seguito sono elencati alcuni esempi di come utilizzare
OutputKey
:-
Se si specifica 'DOC-EXAMPLE-BUCKET' come
OutputBucketName
e 'my-transcript.json' comeOutputKey
, il percorso di output della trascrizione ès3://DOC-EXAMPLE-BUCKET/my-transcript.json
. -
Se specifichi 'my-first-transcription' come
MedicalTranscriptionJobName
, 'DOC-EXAMPLE-BUCKET' come e 'my-transcript' comeOutputKey
, il percorso di output della trascrizione ès3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json
.OutputBucketName
-
Se si specifica 'DOC-EXAMPLE-BUCKET' come
OutputBucketName
e 'test-files/my-transcript.json' comeOutputKey
, il percorso di output della trascrizione ès3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json
. -
Se specifichi 'my-first-transcription' come
MedicalTranscriptionJobName
, 'DOC-EXAMPLE-BUCKET' come e 'test-files/my-transcript' come percorso di output dellaOutputKey
trascrizione ès3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json
.OutputBucketName
Se specifichi il nome di una sottocartella del bucket Amazon S3 che non esiste, ne viene creata una automaticamente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.
Modello:
[a-zA-Z0-9-_.!*'()/]{1,1024}$
Required: No
-
- Settings
-
Specifica impostazioni opzionali aggiuntive nellaStartMedicalTranscriptionJob richiesta, tra cui l'identificazione dei canali, le trascrizioni alternative e il partizionamento dei diffusori. Puoi usarlo per applicare vocabolari personalizzati al tuo lavoro di trascrizione.
Tipo: MedicalTranscriptionSetting oggetto
Required: No
- Specialty
-
Specifica la specialità medica predominante rappresentata nei tuoi media. Per le trascrizioni in batch,
PRIMARYCARE
è l'unico valore valido. Se hai bisogno di specialità aggiuntive, consultaStartMedicalStreamTranscription.Tipo: String
Valori validi:
PRIMARYCARE
Campo obbligatorio: sì
- Tags
-
Aggiunge uno o più tag personalizzati, ciascuno sotto forma di coppia chiave:valore, a un nuovo processo di trascrizione medica nel momento in cui inizi questo nuovo lavoro.
Per ulteriori informazioni sull'uso dei tag con Amazon Transcribe, consulta Risorse per etichettatura.
Tipo: matrice di oggetti Tag
Membri dell’array: numero minimo di 1 elemento. Numero massimo massimo massimo massimo massimo massimo massimo massimo di 200 elementi.
Required: No
- Type
-
Specificate se il file multimediale di input contiene una sola persona (
DICTATION
) o contiene una conversazione tra due persone (CONVERSATION
).Ad esempio,
DICTATION
potrebbe essere utilizzato per un professionista medico che desidera trascrivere memo vocali;CONVERSATION
potrebbe essere utilizzato per trascrivere il dialogo medico-paziente durante la visita ambulatoriale del paziente.Tipo: String
Valori validi:
CONVERSATION | DICTATION
Campo obbligatorio: sì
Sintassi della risposta
{
"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"
}
}
Elementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- MedicalTranscriptionJob
-
Fornisce informazioni dettagliate sull'attuale lavoro di trascrizione medica, incluso lo stato del lavoro e, se applicabile, il motivo del fallimento.
Tipo: MedicalTranscriptionJob oggetto
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- BadRequestException
-
La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempio
IN PROGRESS
). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.Codice di stato HTTP: 400
- ConflictException
-
Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci all'interno di unaAccount AWS.
Codice di stato HTTP: 400
- InternalFailureException
-
Si è verificato un errore interno. Controlla il messaggio di errore, correggi il problema e riprova la richiesta.
Codice di stato HTTP: 500
- LimitExceededException
-
Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: