CallAnalyticsJob - Transcribe
ÍndiceConsulte também

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á.

CallAnalyticsJob

Fornece informações detalhadas sobre uma tarefa do Call Analytics.

Para ver o status do trabalho, consulteCallAnalyticsJobStatus. Se o status forCOMPLETED, o trabalho está concluído. Você pode encontrar sua transcrição completa no URI especificado emTranscriptFileUri. Se o status forFAILED,FailureReason fornece detalhes sobre por que seu trabalho de transcrição falhou.

Se você ativou a redação de informações de identificação pessoal (PII), a transcrição editada aparecerá no local especificado emRedactedTranscriptFileUri.

Se você optar por redigir o áudio em seu arquivo de mídia, poderá encontrar o arquivo de mídia editado no local especificado noRedactedMediaFileUri campo da sua resposta.

Índice

CallAnalyticsJobName

O nome do trabalho do Call Analytics. Os nomes de Job diferenciam maiúsculas de minúsculas e devem ser exclusivos dentro de umaConta 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

CallAnalyticsJobStatus

Fornece o status da tarefa especificada do Call Analytics.

Se o status forCOMPLETED, o trabalho foi concluído e você poderá encontrar os resultados no local especificado emTranscriptFileUri (ouRedactedTranscriptFileUri, se você solicitou a redação da transcrição). Se o status forFAILED,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

ChannelDefinitions

Indica qual alto-falante está em qual canal.

Tipo: matriz de objetos ChannelDefinition

Membros da matriz: número fixo de 2 itens.

Obrigatório: não

CompletionTime

A data e a hora em que o processamento do trabalho especificado do Call Analytics terminou.

Os carimbos de data e hora estão no formatoYYYY-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

CreationTime

A data e a hora em que a solicitação de trabalho especificada do Call Analytics foi feita.

Os carimbos de data e hora estão no formatoYYYY-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

DataAccessRoleArn

O nome do recurso da Amazon (ARN) que incluiu na solicitação.

Tipo: String

Restrições de tamanho: tamanho mínimo 20. Tamanho máximo de 2048.

Padrão: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

Obrigatório: não

FailureReason

SeCallAnalyticsJobStatus forFAILED,FailureReason contém informações sobre por que a solicitação de trabalho do Call Analytics falhou.

OFailureReason campo contém um dos seguintes valores:

  • Unsupported media format.

    O formato de mídia especificado emMediaFormat não é válido. Consulte MediaFormatpara obter uma lista de formatos compatíveis.

  • The media format provided does not match the detected media format.

    O formato de mídia especificado emMediaFormat 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 emMediaSampleRateHertz 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 emMediaSampleRateHertz 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.

  • 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.

Tipo: String

Obrigatório: não

IdentifiedLanguageScore

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

LanguageCode

O código de idioma usado para criar seu trabalho de Call Analytics. Para obter uma lista dos idiomas suportados e seus códigos de idioma associados, consulte a tabela de idiomas suportados.

Se você não souber o idioma falado em seu arquivo de mídia, pode omitir esse campo e permitir que o Amazon Transcribe identifique automaticamente o idioma da sua mídia. Para melhorar a precisão da identificação do idioma, você pode incluir vários códigos de idioma e o Amazon Transcribe escolhe a correspondência mais próxima para sua transcrição.

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

Media

Fornece a localização do Amazon S3 do arquivo de mídia que você usou em sua solicitação de análise de chamadas.

Tipo: objeto Media

Obrigatório: não

MediaFormat

O formato do arquivo de mídia de entrada.

Tipo: String

Valores válidos: mp3 | mp4 | wav | flac | ogg | amr | webm

Obrigatório: não

MediaSampleRateHertz

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

Settings

Fornece informações sobre quaisquer configurações adicionais que foram incluídas em sua solicitação. As configurações adicionais incluem configurações de redação de conteúdo e identificação de idioma.

Tipo: objeto CallAnalyticsJobSettings

Obrigatório: não

StartTime

A data e a hora em que o trabalho especificado do Call Analytics começou a ser processado.

Os carimbos de data e hora estão no formatoYYYY-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

Transcript

Fornece o URI do Amazon S3 que pode ser usado para acessar a transcrição.

Tipo: objeto Transcript

Obrigatório: não

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte: