

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

# StartTranscriptionJob
<a name="API_StartTranscriptionJob"></a>

Transcreve o áudio de um arquivo de mídia e aplica quaisquer parâmetros de solicitação adicionais que você escolher incluir em sua solicitação.

Para fazer uma`StartTranscriptionJob` solicitação, você deve primeiro carregar seu arquivo de mídia em um bucket do Amazon S3; depois, você pode especificar a localização do arquivo no Amazon S3 usando o`Media` parâmetro.

Você deve incluir os seguintes parâmetros em sua`StartTranscriptionJob` solicitação:
+  `region`: ORegião da AWS local em que você está fazendo sua solicitação. Para obter uma lista deRegiões da AWS opções compatíveis com o Amazon Transcribe, consulte os [endpoints e cotas do Amazon Transcribe](https://docs.aws.amazon.com/general/latest/gr/transcribe.html).
+  `TranscriptionJobName`: um nome personalizado que você cria para seu trabalho de transcrição que é exclusivo dentro do seuConta da AWS.
+  `Media`(`MediaFileUri`): A localização do seu arquivo de mídia no Amazon S3.
+ Um dos`LanguageCode``IdentifyLanguage`, ou`IdentifyMultipleLanguages`: Se você souber o idioma do seu arquivo de mídia, especifique-o usando o`LanguageCode` parâmetro; você pode encontrar todos os códigos de idioma válidos na tabela [Idiomas suportados](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html). Se você não conhece os idiomas falados em sua mídia, use um`IdentifyLanguage` ou`IdentifyMultipleLanguages` e deixe que o Amazon Transcribe identifique os idiomas para você.

## Sintaxe da solicitação
<a name="API_StartTranscriptionJob_RequestSyntax"></a>

```
{
   "ContentRedaction": { 
      "PiiEntityTypes": [ "{{string}}" ],
      "RedactionOutput": "{{string}}",
      "RedactionType": "{{string}}"
   },
   "IdentifyLanguage": {{boolean}},
   "IdentifyMultipleLanguages": {{boolean}},
   "JobExecutionSettings": { 
      "AllowDeferredExecution": {{boolean}},
      "DataAccessRoleArn": "{{string}}"
   },
   "KMSEncryptionContext": { 
      "{{string}}" : "{{string}}" 
   },
   "LanguageCode": "{{string}}",
   "LanguageIdSettings": { 
      "{{string}}" : { 
         "LanguageModelName": "{{string}}",
         "VocabularyFilterName": "{{string}}",
         "VocabularyName": "{{string}}"
      }
   },
   "LanguageOptions": [ "{{string}}" ],
   "Media": { 
      "MediaFileUri": "{{string}}",
      "RedactedMediaFileUri": "{{string}}"
   },
   "MediaFormat": "{{string}}",
   "MediaSampleRateHertz": {{number}},
   "ModelSettings": { 
      "LanguageModelName": "{{string}}"
   },
   "OutputBucketName": "{{string}}",
   "OutputEncryptionKMSKeyId": "{{string}}",
   "OutputKey": "{{string}}",
   "Settings": { 
      "ChannelIdentification": {{boolean}},
      "MaxAlternatives": {{number}},
      "MaxSpeakerLabels": {{number}},
      "ShowAlternatives": {{boolean}},
      "ShowSpeakerLabels": {{boolean}},
      "VocabularyFilterMethod": "{{string}}",
      "VocabularyFilterName": "{{string}}",
      "VocabularyName": "{{string}}"
   },
   "Subtitles": { 
      "Formats": [ "{{string}}" ],
      "OutputStartIndex": {{number}}
   },
   "Tags": [ 
      { 
         "Key": "{{string}}",
         "Value": "{{string}}"
      }
   ],
   "TranscriptionJobName": "{{string}}"
}
```

## Parâmetros de solicitação
<a name="API_StartTranscriptionJob_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [ContentRedaction](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-ContentRedaction"></a>
Permite redigir ou sinalizar informações de identificação pessoal (PII) (PII) em sua transcrição). Se você usar`ContentRedaction`, também deverá incluir os subparâmetros:`PiiEntityTypes``RedactionOutput`,`RedactionType` e.  
Tipo: objeto [ContentRedaction](API_ContentRedaction.md)  
Obrigatório: não

 ** [IdentifyLanguage](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-IdentifyLanguage"></a>
Permite a identificação automática do idioma em sua solicitação de trabalho de transcrição. Use esse parâmetro se seu arquivo de mídia contiver somente um idioma. Se sua mídia contiver vários idiomas, use`IdentifyMultipleLanguages` em vez disso.  
Se você incluir`IdentifyLanguage`, você pode, opcionalmente, incluir uma lista de códigos de idioma, usando`LanguageOptions`, que você acha que podem estar presentes em seu arquivo de mídia. `LanguageOptions`Incluir restrições somente`IdentifyLanguage` às opções de idioma que você especificar, o que pode melhorar a precisão da transcrição.  
Se você quiser aplicar um modelo de idioma personalizado, um vocabulário personalizado ou um filtro de vocabulário personalizado à sua solicitação de identificação automática de idioma,`LanguageIdSettings` inclua os subparâmetros relevantes (`VocabularyName``LanguageModelName`, e`VocabularyFilterName`). Se você incluir`LanguageIdSettings`, inclua também`LanguageOptions`.  
Observe que você deve incluir um dos`LanguageCode``IdentifyLanguage`, ou`IdentifyMultipleLanguages` em sua solicitação. Se você incluir mais de um desses parâmetros, seu trabalho de transcrição falhará.  
Tipo: booliano  
Obrigatório: não

 ** [IdentifyMultipleLanguages](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-IdentifyMultipleLanguages"></a>
Permite a identificação automática em vários idiomas em sua solicitação de trabalho de transcrição. Use esse parâmetro se seu arquivo de mídia contiver mais de um idioma. Se sua mídia contiver apenas um idioma, use`IdentifyLanguage` em vez disso.  
Se você incluir`IdentifyMultipleLanguages`, você pode, opcionalmente, incluir uma lista de códigos de idioma, usando`LanguageOptions`, que você acha que podem estar presentes em seu arquivo de mídia. `LanguageOptions`Incluir restrições somente`IdentifyLanguage` às opções de idioma que você especificar, o que pode melhorar a precisão da transcrição.  
Se você quiser aplicar um vocabulário personalizado ou um filtro de vocabulário personalizado à sua solicitação de identificação automática de idioma,`LanguageIdSettings` inclua os subparâmetros relevantes (`VocabularyName`e`VocabularyFilterName`). Se você incluir`LanguageIdSettings`, inclua também`LanguageOptions`.  
Observe que você deve incluir um dos`LanguageCode``IdentifyLanguage`, ou`IdentifyMultipleLanguages` em sua solicitação. Se você incluir mais de um desses parâmetros, seu trabalho de transcrição falhará.  
Tipo: booliano  
Obrigatório: não

 ** [JobExecutionSettings](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-JobExecutionSettings"></a>
Permite controlar como seu trabalho de transcrição é processado. Atualmente, a única`JobExecutionSettings` modificação que você pode escolher é habilitar o enfileiramento de trabalhos usando o`AllowDeferredExecution` subparâmetro.  
Se você incluir`JobExecutionSettings` em sua solicitação, também deverá incluir os subparâmetros:`AllowDeferredExecution``DataAccessRoleArn` e.  
Tipo: objeto [JobExecutionSettings](API_JobExecutionSettings.md)  
Obrigatório: não

 ** [KMSEncryptionContext](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-KMSEncryptionContext"></a>
Um mapa de pares chave-valor não secretos de texto simples, conhecidos como pares de contexto de criptografia, que fornecem uma camada adicional de segurança para seus dados. Para obter mais informações, consulte [contextoAWS KMS de criptografia](https://docs.aws.amazon.com/transcribe/latest/dg/key-management.html#kms-context) e [Chaves assimétricas emAWS KMS](https://docs.aws.amazon.com/transcribe/latest/dg/symmetric-asymmetric.html).  
Tipo:: mapa de string para string  
Entradas do mapa: número máximo de 10 itens.  
Restrições de tamanho de chave: tamanho mínimo de 1. Tamanho máximo de 2000.  
Padrão da chave: `.*\S.*`   
Restrições de tamanho do valor: tamanho mínimo de 1. Tamanho máximo de 2000.  
Padrão de valor:`.*\S.*`   
Obrigatório: não

 ** [LanguageCode](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-LanguageCode"></a>
O código do idioma que representa o idioma falado no arquivo de mídia de entrada.  
Se você não tiver certeza do idioma falado em seu arquivo de mídia, considere usar`IdentifyLanguage` ou`IdentifyMultipleLanguages` habilitar a identificação automática do idioma.  
Observe que você deve incluir um dos`LanguageCode``IdentifyLanguage`, ou`IdentifyMultipleLanguages` em sua solicitação. Se você incluir mais de um desses parâmetros, seu trabalho de transcrição falhará.  
Para obter uma lista dos idiomas suportados e seus códigos de idioma associados, consulte a tabela de [idiomas suportados](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html).  
Para transcrever a fala em árabe padrão moderno (`ar-SA`), seu arquivo de mídia deve ser codificado a uma taxa de amostragem de 16.000 Hz ou superior.
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

 ** [LanguageIdSettings](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-LanguageIdSettings"></a>
Se estiver usando a identificação automática de idioma em sua solicitação e você quiser aplicar um modelo de idioma personalizado, um vocabulário personalizado ou um filtro de vocabulário personalizado,`LanguageIdSettings` inclua os subparâmetros relevantes (`VocabularyName``LanguageModelName`, e`VocabularyFilterName`). Observe que a identificação multilíngue (`IdentifyMultipleLanguages`) não oferece suporte a modelos de linguagem personalizados.  
 `LanguageIdSettings`suporta códigos de dois a cinco idiomas. Cada código de idioma que você incluir pode ter um modelo de idioma personalizado associado, vocabulário personalizado e filtro de vocabulário personalizado. Os códigos de idioma que você especificar devem corresponder aos idiomas dos modelos de idioma personalizados associados, vocabulários personalizados e filtros de vocabulário personalizados.  
É recomendável que você inclua`LanguageOptions` ao usar`LanguageIdSettings` para garantir que o dialeto correto do idioma seja identificado. Por exemplo, se você especificar um vocabulário personalizado que está em uso`en-US`, mas o Amazon Transcribe determina que o idioma falado em sua mídia é`en-AU`, seu vocabulário personalizado *não* será aplicado à sua transcrição. Se você incluir`LanguageOptions` e incluir`en-US` como único dialeto em inglês, seu vocabulário personalizado *será* aplicado à sua transcrição.  
Se você quiser incluir um modelo de idioma personalizado em sua solicitação, mas **não** quiser usar a identificação automática de idioma, use o` ModelSettings ` parâmetro com o`LanguageModelName` subparâmetro. Se você quiser incluir um vocabulário personalizado ou um filtro de vocabulário personalizado (ou ambos) em sua solicitação, mas **não** quiser usar a identificação automática de idioma, use o` Settings ` parâmetro com o subparâmetro`VocabularyName` ou`VocabularyFilterName` (ou ambos).  
Tipo: mapa de string para[LanguageIdSettings](API_LanguageIdSettings.md) o 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](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-LanguageOptions"></a>
Você pode especificar dois ou mais códigos de idioma que representem os idiomas que você acha que podem estar presentes na sua mídia. Incluir mais de cinco não é recomendado. Se você não tiver certeza de quais idiomas estão presentes, não inclua esse parâmetro.  
Se você incluir`LanguageOptions` em sua solicitação, também deverá incluir`IdentifyLanguage`.  
Para obter mais informações, consulte [Idiomas suportados](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html).  
Para transcrever a fala em árabe padrão moderno (`ar-SA`), seu arquivo de mídia deve ser codificado a uma taxa de amostragem de 16.000 Hz ou superior.  
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](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-Media"></a>
Descreve a localização do arquivo de mídia no Amazon S3 que você deseja usar em sua solicitação.  
Tipo: objeto [Media](API_Media.md)  
Obrigatório: Sim

 ** [MediaFormat](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-MediaFormat"></a>
Especifique o formato do seu arquivo de mídia de entrada.  
Tipo: String  
Valores válidos:` mp3 | mp4 | wav | flac | ogg | amr | webm`   
Obrigatório: não

 ** [MediaSampleRateHertz](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-MediaSampleRateHertz"></a>
A taxa de amostragem, em hertz, da faixa de áudio em seu arquivo de mídia de entrada.  
Se você não especificar a taxa de amostragem de mídia, o Amazon Transcribe a determinará para você. Se você especificar a taxa de amostragem, ela deverá corresponder à taxa detectada pelo Amazon Transcribe. Se houver uma incompatibilidade entre o valor que você especifica e o valor detectado, seu trabalho falhará. Na maioria dos casos, você pode omitir`MediaSampleRateHertz` e deixar o Amazon Transcribe determinar a taxa de amostragem.  
Tipo: inteiro  
Intervalo válido: valor mínimo de 8000. Valor máximo de 48000.  
Obrigatório: não

 ** [ModelSettings](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-ModelSettings"></a>
Especifique o modelo de idioma personalizado que você deseja incluir em seu trabalho de transcrição. Se você incluir`ModelSettings` em sua solicitação, deverá incluir o`LanguageModelName` subparâmetro.  
Para obter mais informações, consulte [Modelos de linguagem personalizados](https://docs.aws.amazon.com/transcribe/latest/dg/custom-language-models.html).  
Tipo: objeto [ModelSettings](API_ModelSettings.md)  
Obrigatório: não

 ** [OutputBucketName](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-OutputBucketName"></a>
O nome do bucket do Amazon S3 onde você deseja armazenar sua saída de transcrição. Não inclua o`S3://` prefixo do bucket especificado.  
Se você quiser que sua saída vá para uma subpasta desse bucket, especifique-a usando o`OutputKey` parâmetro;`OutputBucketName` só aceita o nome de um bucket.  
Por exemplo, se você quiser que sua saída seja armazenada em`S3://DOC-EXAMPLE-BUCKET`,`OutputBucketName` defina como`DOC-EXAMPLE-BUCKET`. No entanto, se você quiser que sua saída seja armazenada em`S3://DOC-EXAMPLE-BUCKET/test-files/`,`OutputBucketName` defina como`DOC-EXAMPLE-BUCKET` e`OutputKey` para`test-files/`.  
Observe que o Amazon Transcribe deve ter permissão para usar o local especificado. Você pode alterar as permissões do Amazon S3 usando [Console de gerenciamento da AWS](https://console.aws.amazon.com/s3)o. Consulte também [Permissões necessárias para funções de usuário do IAM](https://docs.aws.amazon.com/transcribe/latest/dg/security_iam_id-based-policy-examples.html#auth-role-iam-user).  
Se você não especificar`OutputBucketName`, sua transcrição será colocada em um bucket Amazon S3 gerenciado por serviços e você receberá um URI para acessar sua transcrição.  
Tipo: String  
Restrições de comprimento: comprimento máximo de 64.  
Padrão: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]`   
Obrigatório: não

 ** [OutputEncryptionKMSKeyId](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-OutputEncryptionKMSKeyId"></a>
A chave do KMS que você deseja usar para criptografar sua saída de transcrição.  
Se estiver usando uma chave localizada na **atual**Conta da AWS, você pode especificar sua chave KMS de uma das quatro maneiras:  

1. Use o próprio ID da chave KMS. Por exemplo, `1234abcd-12ab-34cd-56ef-1234567890ab`.

1. Use um alias para o ID da chave do KMS. Por exemplo, `alias/ExampleAlias`.

1. Use o nome do recurso da Amazon (ARN) para o ID da chave do KMS). Por exemplo, `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.

1. Use o ARN para o alias da chave do KMS. Por exemplo, `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
Se estiver usando uma chave localizada em umaConta da AWS posição **diferente** da atualConta da AWS, você pode especificar sua chave KMS de duas maneiras:  

1. Use o ARN para o ID da chave KMS. Por exemplo, `arn:aws:kms:region:account-ID:key/1234abcd-12ab-34cd-56ef-1234567890ab`.

1. Use o ARN para o alias da chave do KMS. Por exemplo, `arn:aws:kms:region:account-ID:alias/ExampleAlias`.
Se você não especificar uma chave de criptografia), sua saída será criptografada com a chave do Amazon S3) (Chave do Amazon S3) (SSE-S3)).  
Se você especificar uma chave KMS para criptografar sua saída, também deverá especificar um local de saída usando o`OutputLocation` parâmetro.  
Observe que a função que faz a[StartCallAnalyticsJob](API_StartCallAnalyticsJob.md) solicitação deve ter permissão para usar a chave do KMS selecionada.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 2048.  
Padrão: `^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$`   
Obrigatório: não

 ** [OutputKey](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-OutputKey"></a>
Use em combinação com`OutputBucketName` para especificar o local de saída de sua transcrição e, opcionalmente, um nome exclusivo para seu arquivo de saída. O nome padrão para sua saída de transcrição é o mesmo que você especificou para sua tarefa de transcrição (`TranscriptionJobName`).  
Estes são alguns exemplos de como você pode usar`OutputKey`:  
+ Se você especificar 'DOC-EXAMPLE-BUCKET' como`OutputBucketName` e 'my-transcript.json' como o`OutputKey`, seu caminho de saída da transcrição será`s3://DOC-EXAMPLE-BUCKET/my-transcript.json`.
+ Se você especificar 'my-first-transcription' como o`TranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' como e 'my-transcript' como o`OutputKey`, seu caminho de saída da transcrição será`s3://DOC-EXAMPLE-BUCKET/my-transcript/my-first-transcription.json`.`OutputBucketName`
+ Se você especificar 'DOC-EXAMPLE-BUCKET' como`OutputBucketName` e 'test-files/my-transcript.json' como o`OutputKey`, seu caminho de saída da transcrição será`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript.json`.
+ Se você especificar 'my-first-transcription' como o`TranscriptionJobName`, 'DOC-EXAMPLE-BUCKET' como o`OutputBucketName` e 'test-files/my-transcript' como o`OutputKey`, seu caminho de saída da transcrição será`s3://DOC-EXAMPLE-BUCKET/test-files/my-transcript/my-first-transcription.json`.
Se você especificar o nome de uma subpasta de bucket do Amazon S3 que não existe, uma será criada para você.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1024.  
Padrão: `[a-zA-Z0-9-_.!*'()/]{1,1024}$`   
Obrigatório: não

 ** [Settings](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-Settings"></a>
Especifique configurações opcionais adicionais em sua[StartTranscriptionJob](#API_StartTranscriptionJob) solicitação, incluindo identificação de canal, transcrições alternativas e particionamento de alto-falantes. Você pode usar isso para aplicar vocabulários e filtros de vocabulário personalizados.  
Se você quiser incluir um vocabulário personalizado ou um filtro de vocabulário personalizado (ou ambos) em sua solicitação, mas **não** quiser usar a identificação automática de idioma, use`Settings` com o subparâmetro`VocabularyName` ou`VocabularyFilterName` (ou ambos).  
Se você estiver usando a identificação automática de idioma com sua solicitação e quiser incluir um modelo de idioma personalizado, um vocabulário personalizado ou um filtro de vocabulário personalizado, use o` LanguageIdSettings ` parâmetro com`VocabularyFilterName` os subparâmetros`VocabularyName` ou.`LanguageModelName`  
Tipo: objeto [Settings](API_Settings.md)  
Obrigatório: não

 ** [Subtitles](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-Subtitles"></a>
Produz arquivos de legenda para sua mídia de entrada. Você pode especificar os formatos WebVTT (\*.vtt) e SubRip (\*.srt).  
Tipo: objeto [Subtitles](API_Subtitles.md)  
Obrigatório: não

 ** [Tags](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-Tags"></a>
Adiciona uma ou mais tags personalizadas, cada uma na forma de um par chave:valor, a um novo trabalho de transcrição no momento em que você inicia esse novo trabalho.  
Para saber mais sobre como usar tags com o Amazon Transcribe, consulte os [recursos de marcação](https://docs.aws.amazon.com/transcribe/latest/dg/tagging.html).  
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

 ** [TranscriptionJobName](#API_StartTranscriptionJob_RequestSyntax) **   <a name="transcribe-StartTranscriptionJob-request-TranscriptionJobName"></a>
Um nome exclusivo, escolhido por você, para seu trabalho de transcrição. O nome que você especifica também é usado como o nome padrão do seu arquivo de saída de transcrição. Se você quiser especificar um nome diferente para sua saída de transcrição, use o`OutputKey` parâmetro.  
Esse nome diferencia maiúsculas de minúsculas, não pode conter espaços e deve ser exclusivo em umConta da AWS. Se você tentar criar um novo trabalho com o mesmo nome de um trabalho existente, você receberá um`ConflictException` erro.  
Tipo: String  
Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 200.  
Padrão: `^[0-9a-zA-Z._-]+`   
Obrigatório: Sim

## Sintaxe da resposta
<a name="API_StartTranscriptionJob_ResponseSyntax"></a>

```
{
   "TranscriptionJob": { 
      "CompletionTime": number,
      "ContentRedaction": { 
         "PiiEntityTypes": [ "string" ],
         "RedactionOutput": "string",
         "RedactionType": "string"
      },
      "CreationTime": number,
      "FailureReason": "string",
      "IdentifiedLanguageScore": number,
      "IdentifyLanguage": boolean,
      "IdentifyMultipleLanguages": boolean,
      "JobExecutionSettings": { 
         "AllowDeferredExecution": boolean,
         "DataAccessRoleArn": "string"
      },
      "LanguageCode": "string",
      "LanguageCodes": [ 
         { 
            "DurationInSeconds": number,
            "LanguageCode": "string"
         }
      ],
      "LanguageIdSettings": { 
         "string" : { 
            "LanguageModelName": "string",
            "VocabularyFilterName": "string",
            "VocabularyName": "string"
         }
      },
      "LanguageOptions": [ "string" ],
      "Media": { 
         "MediaFileUri": "string",
         "RedactedMediaFileUri": "string"
      },
      "MediaFormat": "string",
      "MediaSampleRateHertz": number,
      "ModelSettings": { 
         "LanguageModelName": "string"
      },
      "Settings": { 
         "ChannelIdentification": boolean,
         "MaxAlternatives": number,
         "MaxSpeakerLabels": number,
         "ShowAlternatives": boolean,
         "ShowSpeakerLabels": boolean,
         "VocabularyFilterMethod": "string",
         "VocabularyFilterName": "string",
         "VocabularyName": "string"
      },
      "StartTime": number,
      "Subtitles": { 
         "Formats": [ "string" ],
         "OutputStartIndex": number,
         "SubtitleFileUris": [ "string" ]
      },
      "Tags": [ 
         { 
            "Key": "string",
            "Value": "string"
         }
      ],
      "Transcript": { 
         "RedactedTranscriptFileUri": "string",
         "TranscriptFileUri": "string"
      },
      "TranscriptionJobName": "string",
      "TranscriptionJobStatus": "string"
   }
}
```

## Elementos de resposta
<a name="API_StartTranscriptionJob_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta HTTP 200.

Os seguintes dados são retornados no formato JSON pelo serviço.

 ** [TranscriptionJob](#API_StartTranscriptionJob_ResponseSyntax) **   <a name="transcribe-StartTranscriptionJob-response-TranscriptionJob"></a>
Fornece informações detalhadas sobre o trabalho de transcrição atual, incluindo o status do trabalho e, se aplicável, o motivo da falha.  
Tipo: objeto [TranscriptionJob](API_TranscriptionJob.md)

## Erros
<a name="API_StartTranscriptionJob_Errors"></a>

Para obter informações sobre os erros comuns a todas as ações, consulte[Erros comuns](CommonErrors.md).

 ** BadRequestException **   
Sua solicitação não passou em um ou mais testes de validação. Isso pode ocorrer quando a entidade que você está tentando excluir não existe ou se está em um estado não terminal (como`IN PROGRESS`). Consulte o campo da mensagem de exceção para obter mais informações.  
Código de status HTTP: 400

 ** ConflictException **   
Já existe um recurso com esse nome. Os nomes dos recursos devem ser exclusivos em umConta da AWS.  
Código de status HTTP: 400

 ** InternalFailureException **   
Ocorreu um erro interno. Verifique a mensagem de erro, corrija o problema e tente fazer sua solicitação novamente.  
Código de status HTTP: 500

 ** LimitExceededException **   
Você enviou muitas solicitações ou seu arquivo de entrada é muito longo. Espere antes de repetir sua solicitação ou use um arquivo menor e tente novamente.  
Código de status HTTP: 400

## Consulte também
<a name="API_StartTranscriptionJob_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 Command Line Interface](https://docs.aws.amazon.com/goto/aws-cli/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK for .NET](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK for C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK for Go](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWSSDK para JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/transcribe-2017-10-26/StartTranscriptionJob) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-2017-10-26/StartTranscriptionJob) 