Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # StartMedicalTranscriptionJob Transcribe el audio de un dictado o conversación médica y aplica cualquier parámetro de solicitud adicional que elija incluir en su solicitud. Además de muchas funciones de transcripción estándar, Amazon Transcribe Medical le proporciona un vocabulario médico sólido y, opcionalmente, una identificación de contenido, que añade indicadores a la información de salud personal (PHI). Para obtener más información sobre estas funciones, consulte [Cómo funciona Amazon Transcribe Medical](https://docs.aws.amazon.com/transcribe/latest/dg/how-it-works-med.html). Para realizar una`StartMedicalTranscriptionJob` solicitud, primero debe cargar el archivo multimedia en un bucket de Amazon S3; a continuación, puede especificar la ubicación del archivo en S3 mediante el`Media` parámetro. Debe incluir los siguientes parámetros en su`StartMedicalTranscriptionJob` solicitud: + `region`: ElRegión de AWS lugar donde realiza su solicitud. Para obtener una lista de lasRegiones de AWS opciones compatibles con Amazon Transcribe, consulte los [puntos de conexión y cuotas de Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html). + `MedicalTranscriptionJobName`: un nombre personalizado que creas para tu trabajo de transcripción y que es único dentro de tuCuenta de AWS. + `Media`(`MediaFileUri`): la ubicación de Amazon S3 de su archivo multimedia. + `LanguageCode`: Esto debe ser`en-US`. + `OutputBucketName`: bucket de Amazon S3 en el que desea almacenar su transcripción. Si desea que su salida se almacene en una subcarpeta de este bucket, también debe incluirla`OutputKey`. + `Specialty`: Esto debe ser`PRIMARYCARE`. + `Type`: Elige si el audio es una conversación o un dictado. ## Sintaxis de la solicitud ``` { "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" } ``` ## Parámetros de solicitud Para obtener información sobre los parámetros comunes a todas las acciones, consulte [Parámetros comunes](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [ContentIdentificationType](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Etiqueta toda la información sanitaria personal (PHI) [Clave de salud (PHI)]. Para obtener más información, consulte [Identificar la información de salud personal (PHI) en una transcripción](https://docs.aws.amazon.com/transcribe/latest/dg/phi-id.html). Tipo: cadena Valores válidos:` PHI` Obligatorio: no ** [KMSEncryptionContext](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Un mapa de pares clave-valor no secretos en texto plano, conocidos como pares de contextos de cifrado, que proporcionan una capa adicional de seguridad para los datos. Para obtener más información, consulte [el contexto deAWS KMS cifrado](https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context) y [las claves asimétricas enAWS KMS](https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html). Tipo: mapa de cadena a cadena Entradas de mapa: número máximo de 10 elementos. Limitaciones de longitud de la clave: longitud mínima de 1. La longitud máxima es de 2000 caracteres. Patrón de clave: `.*\S.*` Limitaciones de longitud de los valores: longitud mínima de 1. La longitud máxima es de 2000 caracteres. Patrón de valores:`.*\S.*` Obligatorio: no ** [LanguageCode](#API_StartMedicalTranscriptionJob_RequestSyntax) ** El código de idioma que representa el idioma hablado en el archivo multimedia de entrada. El inglés estadounidense (`en-US`) es el único valor válido para trabajos de transcripción médica. Cualquier otro valor que introduzca para el código de idioma generará un`BadRequestException` error. Tipo: cadena Valores válidos:` 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` Obligatorio: sí ** [Media](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Describe la ubicación de Amazon S3 del archivo multimedia que desea usar en su solicitud. Para obtener información sobre los formatos multimedia compatibles, consulte el [MediaFormat](https://docs.aws.amazon.com/APIReference/API_StartTranscriptionJob.html#transcribe-StartTranscriptionJob-request-MediaFormat)parámetro o la sección [Formatos multimedia](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio) de la Guía para desarrolladores de Amazon S3. Tipo: objeto [Media](API_Media.md) Obligatorio: sí ** [MediaFormat](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Especifique el formato del archivo multimedia de entrada. Tipo: cadena Valores válidos:` mp3 | mp4 | wav | flac | ogg | amr | webm` Obligatorio: no ** [MediaSampleRateHertz](#API_StartMedicalTranscriptionJob_RequestSyntax) ** La frecuencia de muestreo, en hercios, de la pista de audio del archivo multimedia de entrada. Si no especifica la frecuencia de muestreo del contenido multimedia, Amazon Transcribe Medical la determinará por usted. Si especifica la frecuencia de muestreo, debe coincidir con la frecuencia detectada por Amazon Transcribe Medical; si hay una discrepancia entre el valor que especifica y el valor detectado, se producirá un error en el trabajo. Por lo tanto, en la mayoría de los casos, se recomienda omitir`MediaSampleRateHertz` y dejar que Amazon Transcribe Medical determine la frecuencia de muestreo. Tipo: entero Rango válido: valor mínimo de 16000. Valor máximo de 48000. Obligatorio: no ** [MedicalTranscriptionJobName](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Un nombre único, elegido por usted, para su trabajo de transcripción médica. El nombre que especifique también se utilizará como nombre predeterminado del archivo de salida de la transcripción. Si desea especificar un nombre diferente para el resultado de la transcripción, utilice el`OutputKey` parámetro. Este nombre distingue entre mayúsculas y minúsculas, no puede contener espacios y debe ser único dentro de unCuenta de AWS. Si intenta crear un trabajo nuevo con el mismo nombre que un trabajo existente,`ConflictException` aparece un error. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 200 caracteres. Patrón: `^[0-9a-zA-Z._-]+` Obligatorio: sí ** [OutputBucketName](#API_StartMedicalTranscriptionJob_RequestSyntax) ** El nombre del bucket de Amazon S3 en el que desea almacenar sus datos de Amazon S3. No incluya el`S3://` prefijo del bucket especificado. Si desea que la salida vaya a una subcarpeta de este depósito, especifíquelo mediante el`OutputKey` parámetro;`OutputBucketName` solo acepta el nombre de un depósito. Por ejemplo, si desea almacenar la salida en`S3://DOC-EXAMPLE-BUCKET`,`OutputBucketName` configúrela en`DOC-EXAMPLE-BUCKET`. Sin embargo, si desea almacenar la salida en`S3://DOC-EXAMPLE-BUCKET/test-files/`,`OutputBucketName` defina como`DOC-EXAMPLE-BUCKET` y`OutputKey` como`test-files/`. Tenga en cuenta que Amazon Transcribe debe tener permiso para utilizar la ubicación especificada. Puede cambiar los permisos de Amazon S3 mediante [Consola de administración de AWS](https://console.aws.amazon.com/s3). Consulte también [Permisos necesarios para las funciones de usuario de IAM](https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user). Tipo: cadena Limitaciones de longitud: longitud: longitud: longitud: longitud: longitud: longitud. Patrón: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` Obligatorio: sí ** [OutputEncryptionKMSKeyId](#API_StartMedicalTranscriptionJob_RequestSyntax) ** La clave KMS que desea utilizar para cifrar el resultado de su transcripción médica. Si utiliza una clave ubicada en la **actual**Cuenta de AWS, puede especificar su clave de KMS de una de las cuatro maneras siguientes: 1. Utilice el identificador de clave de KMS propiamente dicho. Por ejemplo, `1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Utilice un alias para el ID de clave KMS. Por ejemplo, `alias/ExampleAlias`. 1. Utilice el Nombre de recurso de Amazon (ARN) para el Nombre de recurso de Amazon (ARN) como clave de Amazon (ARN) para el Por ejemplo, `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Utilice el ARN para el alias de clave KMS. Por ejemplo, `arn:aws:kms:region:account-ID:alias/ExampleAlias`. Si usa una clave ubicada en una ubicación **Cuenta de AWSdiferente** a la actualCuenta de AWS, puede especificar su clave de KMS de dos maneras: 1. Utilice el ARN para el ID de clave de KMS. Por ejemplo, `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`. 1. Utilice el ARN para el alias de clave KMS. Por ejemplo, `arn:aws:kms:region:account-ID:alias/ExampleAlias`. Si no especificas una clave de cifrado, la salida se cifrará con la clave Amazon S3 (SSE-S3) [Clave de Amazon S3 (SSE-S3)]. Si especifica una clave de KMS para cifrar la salida, también debe especificar una ubicación de salida mediante el`OutputLocation` parámetro. Tenga en cuenta que el rol que realiza la[StartCallAnalyticsJob](API_StartCallAnalyticsJob.md) solicitud debe tener permiso para utilizar la clave KMS especificada. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres. Patrón: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$` Obligatorio: no ** [OutputKey](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Úselo en combinación con`OutputBucketName` para especificar la ubicación de salida de la transcripción y, opcionalmente, un nombre único para el archivo de salida. El nombre predeterminado para el resultado de la transcripción es el mismo que especificó para su trabajo de transcripción médica (`MedicalTranscriptionJobName`). A continuación, se muestran algunos ejemplos de cómo puede utilizar`OutputKey`: + Si especifica 'DOC-EXAMPLE-BUCKET' como '`OutputBucketName`y' my-transcript.json 'como`OutputKey`, la ruta de salida de la transcripción es`s3://DOC-EXAMPLE-BUCKET/my-transcript.json`. + Si especifica «my-first-transcription» como`MedicalTranscriptionJobName`, «DOC-EXAMPLE-BUCKET» como y «my-transcription» como`OutputKey`, la ruta de salida de la transcripción es`s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json`.`OutputBucketName` + Si especifica 'DOC-EXAMPLE-BUCKET' como '`OutputBucketName`y' test-files/my-transcript.json 'como`OutputKey`, la ruta de salida de la transcripción es`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json`. + Si especifica «my-first-transcription» como`MedicalTranscriptionJobName`, «DOC-EXAMPLE-BUCKET» como y «test-files/my-transcript» como`OutputKey`, la ruta de salida de la transcripción es`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json`.`OutputBucketName` Si especifica el nombre de una subcarpeta de bucket de Amazon S3 que no existe, se crea una para usted. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres. Patrón: `[a-zA-Z0-9-_.!*'()/]{1,1024}$` Obligatorio: no ** [Settings](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Especifique ajustes opcionales adicionales en su[StartMedicalTranscriptionJob](#API_StartMedicalTranscriptionJob) solicitud, incluida la identificación de canales, las transcripciones alternativas y la partición de los altavoces. Puede usarlo para aplicar vocabularios personalizados a su trabajo de transcripción. Tipo: objeto [MedicalTranscriptionSetting](API_MedicalTranscriptionSetting.md) Obligatorio: no ** [Specialty](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Especifique la especialidad médica predominante representada en sus medios. Para las transcripciones por lotes,`PRIMARYCARE` es el único valor válido. Si necesita especialidades adicionales, consulte[StartMedicalStreamTranscription](API_streaming_StartMedicalStreamTranscription.md). Tipo: cadena Valores válidos:` PRIMARYCARE` Obligatorio: sí ** [Tags](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Añade una o más etiquetas personalizadas, cada una en forma de par clave:valor, a un nuevo trabajo de transcripción médica al iniciar este nuevo trabajo. Para obtener más información sobre cómo usar etiquetas con Amazon Transcribe, consulte Encryption key key key key key ([Recursos de etiquetado](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html)). Tipo: Matriz de objetos [Tag](API_Tag.md) Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 200 elementos. Obligatorio: no ** [Type](#API_StartMedicalTranscriptionJob_RequestSyntax) ** Especifica si el contenido multimedia de entrada contiene solo una persona (`DICTATION`) o si contiene una conversación entre dos personas (`CONVERSATION`). Por ejemplo,`DICTATION` podría usarse para un profesional médico que desee transcribir notas de voz;`CONVERSATION` podría usarse para transcribir el diálogo entre el médico y el paciente durante la visita al consultorio del paciente. Tipo: cadena Valores válidos:` CONVERSATION | DICTATION` Obligatorio: sí ## Sintaxis de la respuesta ``` { "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" } } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [MedicalTranscriptionJob](#API_StartMedicalTranscriptionJob_ResponseSyntax) ** Proporciona información detallada sobre el trabajo actual de transcripción médica, incluido el estado del puesto y, si corresponde, el motivo del fracaso. Tipo: objeto [MedicalTranscriptionJob](API_MedicalTranscriptionJob.md) ## Errores Para obtener información sobre los errores comunes a todas las acciones, consulte[Errores comunes](CommonErrors.md). ** BadRequestException ** Tu solicitud no ha superado una o más pruebas de validación. Esto puede ocurrir cuando la entidad que intentas eliminar no existe o si se encuentra en un estado no terminal (por ejemplo`IN PROGRESS`). Para obtener más información, consulte el campo de mensaje de excepción. Código de estado HTTP: 400 ** ConflictException ** Ya existe un recurso con este nombre. Los nombres de recurso deben ser únicos dentro deCuenta de AWS. Código de estado HTTP: 400 ** InternalFailureException ** Se produjo un error interno. Compruebe el mensaje de error, corrija el problema e inténtelo de nuevo. Código de estado HTTP: 500 ** LimitExceededException ** Has enviado demasiadas solicitudes o tu archivo de entrada es demasiado largo. Espere antes de volver a intentar la solicitud o utilice un archivo más pequeño y vuelva a intentarlo. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: + [AWS Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [SDK de AWS para .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [SDK de AWS para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [SDK de AWS para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartMedicalTranscriptionJob) + [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartMedicalTranscriptionJob)