

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Fornece informações detalhadas sobre um trabalho de transcrição.

Para ver o status do trabalho de transcrição especificado, verifique o`TranscriptionJobStatus` campo. Se o status for`COMPLETED`, o trabalho foi concluído e você poderá encontrar os resultados no local especificado em`TranscriptFileUri`. Se o status for`FAILED`,`FailureReason` fornece detalhes sobre por que seu trabalho de transcrição falhou.

Se você habilitou a redação do conteúdo, a transcrição editada pode ser encontrada no local especificado em`RedactedTranscriptFileUri`.

## Índice
<a name="API_TranscriptionJob_Contents"></a>

 ** CompletionTime **   <a name="transcribe-Type-TranscriptionJob-CompletionTime"></a>
A data e a hora em que o processamento do trabalho de transcrição especificado foi concluído.  
Os carimbos de data e hora estão no formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por exemplo,`2022-05-04T12:33:13.922000-07:00` representa um trabalho de transcrição que começou a ser processado às 12h33 UTC-7 em 4 de maio de 2022.  
Type: timestamp  
Obrigatório: não

 ** ContentRedaction **   <a name="transcribe-Type-TranscriptionJob-ContentRedaction"></a>
Indica se a redação foi ativada em sua transcrição.  
Tipo: objeto [ContentRedaction](API_ContentRedaction.md)  
Obrigatório: não

 ** CreationTime **   <a name="transcribe-Type-TranscriptionJob-CreationTime"></a>
A data e a hora em que a solicitação de trabalho de transcrição especificada foi feita.  
Os carimbos de data e hora estão no formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por exemplo,`2022-05-04T12:32:58.761000-07:00` representa um trabalho de transcrição que começou a ser processado às 12h32 UTC-7 em 4 de maio de 2022.  
Type: timestamp  
Obrigatório: não

 ** FailureReason **   <a name="transcribe-Type-TranscriptionJob-FailureReason"></a>
Em caso`TranscriptionJobStatus``FAILED` afirmativo,`FailureReason` contém informações sobre por que a solicitação de trabalho de transcrição falhou.  
O`FailureReason` campo contém um dos seguintes valores:  
+  `Unsupported media format`.

  O formato de mídia especificado em`MediaFormat` não é válido. Consulte **MediaFormat**para obter uma lista de formatos compatíveis.
+  `The media format provided does not match the detected media format`.

  O formato de mídia especificado em`MediaFormat` não corresponde ao formato do arquivo de entrada. Verifique o formato de mídia do seu arquivo de mídia e corrija o valor especificado.
+  `Invalid sample rate for audio file`.

  A taxa de amostragem especificada em`MediaSampleRateHertz` não é válida. A taxa de amostragem deve estar entre 8.000 e 48.000 hertz.
+  `The sample rate provided does not match the detected sample rate`.

  A taxa de amostragem especificada em`MediaSampleRateHertz` não corresponde à taxa de amostragem detectada em seu arquivo de mídia de entrada. Verifique a taxa de amostragem do seu arquivo de mídia e corrija o valor especificado.
+  `Invalid file size: file size too large`.

  O tamanho do seu arquivo de mídia é maior do que o que o Amazon Transcribe pode processar. Para obter mais informações, consulte [Diretrizes e cotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits).
+  `Invalid number of channels: number of channels too large`.

  Seu áudio contém mais canais do que o Amazon Transcribe é capaz de processar. Para obter mais informações, consulte [Diretrizes e cotas](https://docs.aws.amazon.com/transcribe/latest/dg/limits-guidelines.html#limits).
Tipo: String  
Obrigatório: não

 ** IdentifiedLanguageScore **   <a name="transcribe-Type-TranscriptionJob-IdentifiedLanguageScore"></a>
A pontuação de confiança associada ao idioma identificado em seu arquivo de mídia.  
As pontuações de confiança são valores entre 0 e 1; um valor maior indica uma probabilidade maior de que o idioma identificado corresponda corretamente ao idioma falado em sua mídia.  
Tipo: float  
Obrigatório: não

 ** IdentifyLanguage **   <a name="transcribe-Type-TranscriptionJob-IdentifyLanguage"></a>
Indica se a identificação automática de idioma foi ativada (`TRUE`) para o trabalho de transcrição especificado.  
Tipo: booliano  
Obrigatório: não

 ** IdentifyMultipleLanguages **   <a name="transcribe-Type-TranscriptionJob-IdentifyMultipleLanguages"></a>
Indica se a identificação automática em vários idiomas foi ativada (`TRUE`) para o trabalho de transcrição especificado.  
Tipo: booliano  
Obrigatório: não

 ** JobExecutionSettings **   <a name="transcribe-Type-TranscriptionJob-JobExecutionSettings"></a>
Fornece informações sobre como seu trabalho de transcrição foi processado. Esse parâmetro mostra se sua solicitação foi colocada na fila e qual função de acesso a dados foi usada.  
Tipo: objeto [JobExecutionSettings](API_JobExecutionSettings.md)  
Obrigatório: não

 ** LanguageCode **   <a name="transcribe-Type-TranscriptionJob-LanguageCode"></a>
O código do idioma usado para criar seu trabalho de transcrição. Esse parâmetro é usado com a identificação de um único idioma. Para solicitações de identificação em vários idiomas, consulte a versão plural desse parâmetro,`LanguageCodes`.  
Tipo: String  
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`   
Obrigatório: não

 ** LanguageCodes **   <a name="transcribe-Type-TranscriptionJob-LanguageCodes"></a>
Os códigos de idioma usados para criar seu trabalho de transcrição. Esse parâmetro é usado com identificação em vários idiomas. Para solicitações de identificação de um único idioma, consulte a versão singular desse parâmetro,`LanguageCode`.  
Tipo: matriz de objetos [LanguageCodeItem](API_LanguageCodeItem.md)  
Obrigatório: não

 ** LanguageIdSettings **   <a name="transcribe-Type-TranscriptionJob-LanguageIdSettings"></a>
Fornece o nome e o idioma de todos os modelos de idiomas personalizados, vocabulários personalizados e filtros de vocabulário personalizados que você incluiu em sua solicitação.  
Tipo: mapa de string para o mapa[LanguageIdSettings](API_LanguageIdSettings.md) do objeto  
Entradas do mapa: número máximo de 5 itens.  
Chaves 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`   
Obrigatório: não

 ** LanguageOptions **   <a name="transcribe-Type-TranscriptionJob-LanguageOptions"></a>
Fornece os códigos de idioma que você especificou em sua solicitação.  
Tipo: matriz de strings  
Membros da matriz: número mínimo de 1 item.  
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`   
Obrigatório: não

 ** Media **   <a name="transcribe-Type-TranscriptionJob-Media"></a>
Fornece a localização do arquivo de mídia que você usou em sua solicitação no Amazon S3.  
Tipo: objeto [Media](API_Media.md)  
Obrigatório: não

 ** MediaFormat **   <a name="transcribe-Type-TranscriptionJob-MediaFormat"></a>
O formato do arquivo da mídia de entrada.  
Tipo: String  
Valores válidos:` mp3 | mp4 | wav | flac | ogg | amr | webm`   
Obrigatório: não

 ** MediaSampleRateHertz **   <a name="transcribe-Type-TranscriptionJob-MediaSampleRateHertz"></a>
A taxa de amostragem, em hertz, da faixa de áudio em seu arquivo de mídia de entrada.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 8000. Valor máximo de 48000.  
Obrigatório: não

 ** ModelSettings **   <a name="transcribe-Type-TranscriptionJob-ModelSettings"></a>
Fornece informações sobre o modelo de idioma personalizado que você incluiu em sua solicitação.  
Tipo: objeto [ModelSettings](API_ModelSettings.md)  
Obrigatório: não

 ** Settings **   <a name="transcribe-Type-TranscriptionJob-Settings"></a>
Fornece informações sobre quaisquer configurações adicionais que foram incluídas em sua solicitação. As configurações adicionais incluem identificação de canais, transcrições alternativas, particionamento de alto-falantes, vocabulários personalizados e filtros de vocabulário personalizados.  
Tipo: objeto [Settings](API_Settings.md)  
Obrigatório: não

 ** StartTime **   <a name="transcribe-Type-TranscriptionJob-StartTime"></a>
A data e a hora em que o trabalho de transcrição especificado começou a ser processado.  
Os carimbos de data e hora estão no formato`YYYY-MM-DD'T'HH:MM:SS.SSSSSS-UTC`. Por exemplo,`2022-05-04T12:32:58.789000-07:00` representa um trabalho de transcrição que começou a ser processado às 12h32 UTC-7 em 4 de maio de 2022.  
Type: timestamp  
Obrigatório: não

 ** Subtitles **   <a name="transcribe-Type-TranscriptionJob-Subtitles"></a>
Indica se as legendas foram geradas com sua transcrição.  
Tipo: objeto [SubtitlesOutput](API_SubtitlesOutput.md)  
Obrigatório: não

 ** Tags **   <a name="transcribe-Type-TranscriptionJob-Tags"></a>
As tags, cada uma na forma de um par chave-valor, atribuídas à tarefa de transcrição especificada.  
Tipo: matriz de objetos [Tag](API_Tag.md)  
Membros da matriz: número mínimo de 1 item. Número máximo de 200 itens.  
Obrigatório: não

 ** Transcript **   <a name="transcribe-Type-TranscriptionJob-Transcript"></a>
Fornece o URI do Amazon S3 que pode ser usado para acessar sua transcrição.  
Tipo: objeto [Transcript](API_Transcript.md)  
Obrigatório: não

 ** TranscriptionJobName **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobName"></a>
O nome do trabalho de transcrição. Os nomes dos Job diferenciam maiúsculas de minúsculas e devem ser exclusivos dentro de umConta da AWS.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+`   
Obrigatório: não

 ** TranscriptionJobStatus **   <a name="transcribe-Type-TranscriptionJob-TranscriptionJobStatus"></a>
Fornece o status do trabalho de transcrição especificado.  
Se o status for`COMPLETED`, o trabalho foi concluído e você poderá encontrar os resultados no local especificado em`TranscriptFileUri` (ou`RedactedTranscriptFileUri`, se você solicitou a redação da transcrição). Se o status for`FAILED`,`FailureReason` fornece detalhes sobre por que seu trabalho de transcrição falhou.  
Tipo: String  
Valores válidos:` QUEUED | IN_PROGRESS | FAILED | COMPLETED`   
Obrigatório: não

## Consulte também
<a name="API_TranscriptionJob_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/TranscriptionJob) 
+  [AWS SDK for 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) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/TranscriptionJob) 