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.

# TranscriptionJob
<a name="API_TranscriptionJob"></a>

Proporciona información detallada sobre un trabajo de transcripción.

Para ver el estado del trabajo de transcripción especificado, compruebe el`TranscriptionJobStatus` campo. Si el estado es`COMPLETED`, el trabajo ha finalizado y puede encontrar los resultados en la ubicación especificada en`TranscriptFileUri`. Si el estado es`FAILED`,`FailureReason` proporciona detalles sobre por qué falló tu trabajo de transcripción.

Si habilitó la redacción de contenido, la transcripción redactada se encuentra en la ubicación especificada en`RedactedTranscriptFileUri`.

## Contenido
<a name="API_TranscriptionJob_Contents"></a>

 ** CompletionTime **   <a name="transcribe-Type-TranscriptionJob-CompletionTime"></a>
La fecha y la hora en que finalizó el procesamiento del trabajo de transcripción especificado.  
Las marcas de tiempo están en el formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por ejemplo,`2022-05-04T12:33:13.922000-07:00` representa un trabajo de transcripción que comenzó a procesarse a las 12:33 p. m., hora peninsular española, del 4 de mayo de 2022.  
Tipo: marca temporal  
Obligatorio: no

 ** ContentRedaction **   <a name="transcribe-Type-TranscriptionJob-ContentRedaction"></a>
Indica si la redacción estaba habilitada en su expediente académico.  
Tipo: objeto [ContentRedaction](API_ContentRedaction.md)  
Obligatorio: no

 ** CreationTime **   <a name="transcribe-Type-TranscriptionJob-CreationTime"></a>
La fecha y la hora en que se realizó la solicitud de trabajo de transcripción especificada.  
Las marcas de tiempo están en el formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por ejemplo,`2022-05-04T12:32:58.761000-07:00` representa un trabajo de transcripción que comenzó a procesarse a las 12:32 p. m., hora peninsular española, del 4 de mayo de 2022.  
Tipo: marca temporal  
Obligatorio: no

 ** FailureReason **   <a name="transcribe-Type-TranscriptionJob-FailureReason"></a>
Si`TranscriptionJobStatus` es así`FAILED`,`FailureReason` contiene información sobre por qué falló la solicitud de trabajo de transcripción.  
El`FailureReason` campo contiene uno de los siguientes valores:  
+  `Unsupported media format`.

  El formato multimedia especificado en`MediaFormat` no es válido. Consulte **MediaFormat**para obtener una lista de los formatos admitidos.
+  `The media format provided does not match the detected media format`.

  El formato multimedia especificado en`MediaFormat` no coincide con el formato del archivo de entrada. Compruebe el formato multimedia del archivo multimedia y corrija el valor especificado.
+  `Invalid sample rate for audio file`.

  La frecuencia de muestreo especificada en`MediaSampleRateHertz` no es válida. La frecuencia de muestreo debe estar entre 8 000 y 48 000 hercios.
+  `The sample rate provided does not match the detected sample rate`.

  La frecuencia de muestreo especificada en`MediaSampleRateHertz` no coincide con la frecuencia de muestreo detectada en el archivo multimedia de entrada. Compruebe la frecuencia de muestreo del archivo multimedia y corrija el valor especificado.
+  `Invalid file size: file size too large`.

  El tamaño del archivo multimedia es superior al que Amazon Transcribe puede procesar. Para obtener más información, consulte [Pautas y cuotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits).
+  `Invalid number of channels: number of channels too large`.

  El audio contiene más canales de los que Amazon Transcribe puede procesar. Para obtener más información, consulte [Pautas y cuotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits).
Tipo: cadena  
Requerido: No

 ** IdentifiedLanguageScore **   <a name="transcribe-Type-TranscriptionJob-IdentifiedLanguageScore"></a>
La puntuación de confianza asociada al idioma identificado en el archivo multimedia.  
Las puntuaciones de confianza son valores entre 0 y 1; un valor mayor indica una mayor probabilidad de que el idioma identificado coincida correctamente con el idioma que se habla en el contenido multimedia.  
Tipo: Flotante  
Obligatorio: no

 ** IdentifyLanguage **   <a name="transcribe-Type-TranscriptionJob-IdentifyLanguage"></a>
Indica si la identificación automática de idiomas estaba habilitada (`TRUE`) para el trabajo de transcripción especificado.  
Tipo: booleano  
Obligatorio: no

 ** IdentifyMultipleLanguages **   <a name="transcribe-Type-TranscriptionJob-IdentifyMultipleLanguages"></a>
Indica si se habilitó la identificación automática en varios idiomas (`TRUE`) para el trabajo de transcripción especificado.  
Tipo: booleano  
Obligatorio: no

 ** JobExecutionSettings **   <a name="transcribe-Type-TranscriptionJob-JobExecutionSettings"></a>
Proporciona información sobre cómo se procesó el trabajo de transcripción. Este parámetro muestra si la solicitud estaba en cola y qué rol de acceso a datos se utilizó.  
Tipo: objeto [JobExecutionSettings](API_JobExecutionSettings.md)  
Obligatorio: no

 ** LanguageCode **   <a name="transcribe-Type-TranscriptionJob-LanguageCode"></a>
El código de idioma utilizado para crear tu trabajo de transcripción. Este parámetro se utiliza con la identificación en un solo idioma. Para las solicitudes de identificación en varios idiomas, consulte la versión plural de este parámetro`LanguageCodes`.  
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: no

 ** LanguageCodes **   <a name="transcribe-Type-TranscriptionJob-LanguageCodes"></a>
Los códigos de idioma utilizados para crear tu trabajo de transcripción. Este parámetro se utiliza con la identificación en varios idiomas. Para las solicitudes de identificación en un solo idioma, consulte la versión singular de este parámetro`LanguageCode`.  
Tipo: Matriz de objetos [LanguageCodeItem](API_LanguageCodeItem.md)  
Obligatorio: no

 ** LanguageIdSettings **   <a name="transcribe-Type-TranscriptionJob-LanguageIdSettings"></a>
Proporciona el nombre y el idioma de todos los modelos de idioma personalizados, los vocabularios personalizados y los filtros de vocabulario personalizados que incluiste en tu solicitud.  
Tipo: mapa de cadena a[LanguageIdSettings](API_LanguageIdSettings.md) objeto  
Entradas de mapa: número máximo de 5 elementos.  
Claves válidas:` 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: no

 ** LanguageOptions **   <a name="transcribe-Type-TranscriptionJob-LanguageOptions"></a>
Proporciona los códigos de idioma que especificó en su solicitud.  
Tipo: matriz de cadenas  
Miembros de la matriz: número mínimo de 1 elemento.  
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: no

 ** Media **   <a name="transcribe-Type-TranscriptionJob-Media"></a>
Proporciona la ubicación de Amazon S3 del archivo multimedia que utilizó en su solicitud.  
Tipo: objeto [Media](API_Media.md)  
Obligatorio: no

 ** MediaFormat **   <a name="transcribe-Type-TranscriptionJob-MediaFormat"></a>
El formato del archivo multimedia de entrada.  
Tipo: cadena  
Valores válidos:` mp3 | mp4 | wav | flac | ogg | amr | webm`   
Obligatorio: no

 ** MediaSampleRateHertz **   <a name="transcribe-Type-TranscriptionJob-MediaSampleRateHertz"></a>
La frecuencia de muestreo, en hercios, de la pista de audio del archivo multimedia de entrada.  
Tipo: entero  
Rango válido: valor mínimo de 8000. Valor máximo de 48000.  
Obligatorio: no

 ** ModelSettings **   <a name="transcribe-Type-TranscriptionJob-ModelSettings"></a>
Proporciona información sobre el modelo de idioma personalizado que incluiste en tu solicitud.  
Tipo: objeto [ModelSettings](API_ModelSettings.md)  
Obligatorio: no

 ** Settings **   <a name="transcribe-Type-TranscriptionJob-Settings"></a>
Proporciona información sobre cualquier configuración adicional incluida en la solicitud. Los ajustes adicionales incluyen la identificación de canales, las transcripciones alternativas, la partición de los altavoces, los vocabularios personalizados y los filtros de vocabulario personalizados.  
Tipo: objeto [Settings](API_Settings.md)  
Obligatorio: no

 ** StartTime **   <a name="transcribe-Type-TranscriptionJob-StartTime"></a>
La fecha y la hora en que comenzó a procesarse el trabajo de transcripción especificado.  
Las marcas de tiempo están en el formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por ejemplo,`2022-05-04T12:32:58.789000-07:00` representa un trabajo de transcripción que comenzó a procesarse a las 12:32 p. m., hora peninsular española, del 4 de mayo de 2022.  
Tipo: marca temporal  
Obligatorio: no

 ** Subtitles **   <a name="transcribe-Type-TranscriptionJob-Subtitles"></a>
Indica si los subtítulos se generaron con la transcripción.  
Tipo: objeto [SubtitlesOutput](API_SubtitlesOutput.md)  
Obligatorio: no

 ** Tags **   <a name="transcribe-Type-TranscriptionJob-Tags"></a>
Las etiquetas, cada una en forma de par clave:valor, asignadas al trabajo de transcripción especificado.  
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

 ** Transcript **   <a name="transcribe-Type-TranscriptionJob-Transcript"></a>
Le proporciona el URI de Amazon S3 que puede utilizar para obtener acceso a su expediente académico.  
Tipo: objeto [Transcript](API_Transcript.md)  
Obligatorio: no

 ** TranscriptionJobName **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobName"></a>
El nombre del trabajo de transcripción. Los nombres de Job distinguen mayúsculas de minúsculas y deben ser únicos dentro deCuenta de AWS.  
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: no

 ** TranscriptionJobStatus **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobStatus"></a>
Proporciona el estado del trabajo de transcripción especificado.  
Si el estado es`COMPLETED`, el trabajo ha terminado y puede encontrar los resultados en la ubicación especificada en`TranscriptFileUri` (o`RedactedTranscriptFileUri`, si ha solicitado que se redacte el expediente académico). Si el estado es`FAILED`,`FailureReason` proporciona detalles sobre por qué falló tu trabajo de transcripción.  
Tipo: cadena  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Obligatorio: no

## Véase también
<a name="API_TranscriptionJob_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte:
+  [AWS SDK para C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/TranscriptionJob) 
+  [AWS SDK para Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/TranscriptionJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/TranscriptionJob) 
+  [SDK de AWS para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/TranscriptionJob)