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á. # Usar um vocabulário personalizado Depois que o vocabulário personalizado for criado, você poderá incluí-lo em solicitações de transcrição. Consulte as seções a seguir para ver exemplos. O idioma do vocabulário personalizado que você está incluindo na solicitação deve corresponder ao código de idioma especificado para a sua mídia. Se os idiomas não corresponderem, seu vocabulário personalizado não será aplicado à transcrição e não haverá avisos nem erros. ## Usar um vocabulário personalizado em uma transcrição em lote Para usar um vocabulário personalizado com uma transcrição em lote, veja os seguintes exemplos: ### Console de gerenciamento da AWS 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, escolha **Tarefas de transcrição** e selecione **Criar tarefa** (no canto superior direito). Isso abre a página **Especificar os detalhes da tarefa**. ![Captura de tela do console do Amazon Transcribe: a página “Especificar os detalhes da tarefa”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/console-batch-job-details-1.png) Nomeie seu trabalho e especifique sua mídia de entrada. Opcionalmente, inclua outros campos e escolha **Próximo**. 1. Na parte inferior da página **Configurar tarefa**, no painel **Personalização**, ative **Vocabulário personalizado**. ![Captura de tela do console do Amazon Transcribe: a página “Configurar tarefa”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/console-batch-configure-job-vocab.png) 1. Selecione seu vocabulário personalizado no menu suspenso. Selecione **Criar tarefa** para executar a tarefa de transcrição. ### AWS CLI Este exemplo usa o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e o parâmetro `Settings` com o subparâmetro `VocabularyName`. Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html). ``` aws transcribe start-transcription-job \ --region {{us-west-2}} \ --transcription-job-name {{my-first-transcription-job}} \ --media MediaFileUri=s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}} \ --output-bucket-name {{amzn-s3-demo-bucket}} \ --output-key {{my-output-files}}/ \ --language-code {{en-US}} \ --settings VocabularyName={{my-first-vocabulary}} ``` Veja a seguir outro exemplo usando o comando [start-transcription-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/start-transcription-job.html) e um corpo de solicitação que inclui seu vocabulário personalizado com esse trabalho. ``` aws transcribe start-transcription-job \ --region {{us-west-2}} \ --cli-input-json file://{{my-first-vocabulary-job}}.json ``` O arquivo *my-first-vocabulary-job.json* contém o corpo de solicitação a seguir. ``` { "TranscriptionJobName": "{{my-first-transcription-job}}", "Media": { "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}" }, "OutputBucketName": "{{amzn-s3-demo-bucket}}", "OutputKey": "{{my-output-files}}/", "LanguageCode": "{{en-US}}", "Settings": { "VocabularyName": "{{my-first-vocabulary}}" } } ``` ### AWS SDK para Python (Boto3) Este exemplo usa o AWS SDK para Python (Boto3) para incluir um vocabulário personalizado usando o argumento `Settings` para o método [start\_transcription\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/transcribe.html#TranscribeService.Client.start_transcription_job). Para obter mais informações, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_StartTranscriptionJob.html) e [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Settings.html). Para ver exemplos adicionais de uso dos SDKs da AWS, bem como exemplos específicos de recursos, cenários e entre serviços, consulte o capítulo [Exemplos de código para o Amazon Transcribe usando AWS SDKs](service_code_examples.md). ``` from __future__ import print_function import time import boto3 transcribe = boto3.client('transcribe', '{{us-west-2}}') job_name = "{{my-first-transcription-job}}" job_uri = "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}" transcribe.start_transcription_job( TranscriptionJobName = job_name, Media = { 'MediaFileUri': job_uri }, OutputBucketName = '{{amzn-s3-demo-bucket}}', OutputKey = '{{my-output-files}}/', LanguageCode = '{{en-US}}', Settings = { 'VocabularyName': '{{my-first-vocabulary}}' } ) while True: status = transcribe.get_transcription_job(TranscriptionJobName = job_name) if status['TranscriptionJob']['TranscriptionJobStatus'] in ['COMPLETED', 'FAILED']: break print("Not ready yet...") time.sleep(5) print(status) ``` ## Usar um vocabulário personalizado em uma transcrição de streaming Para usar um vocabulário personalizado com uma transcrição de streaming, veja os seguintes exemplos: ### Console de gerenciamento da AWS 1. Faça login no [Console de gerenciamento da AWS](https://console.aws.amazon.com/transcribe/). 1. No painel de navegação, escolha **Transcrição em tempo real**. Role para baixo até **Personalizações** e expanda esse campo se ele estiver minimizado. ![Captura de tela do console do Amazon Transcribe: a página “Transcrição em tempo real”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/stream-main.png) 1. Ative **Vocabulário personalizado** e selecione um vocabulário personalizado no menu suspenso. ![Captura de tela do console do Amazon Transcribe: o painel expandido “Personalizações”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-stream2.png) Inclua quaisquer outras configurações que você queira aplicar ao seu fluxo. 1. Agora está tudo pronto para transcrever seu fluxo. Selecione **Iniciar transmissão** e comece a falar. Para finalizar o ditado, selecione **Interromper transmissão**. ### Fluxo HTTP/2 Este exemplo cria uma solicitação HTTP/2 que inclui seu vocabulário personalizado. Para obter mais informações sobre como usar streaming HTTP/2 com o Amazon Transcribe, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2). Para obter mais detalhes sobre parâmetros e cabeçalhos específicos do Amazon Transcribe, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html). ``` POST /stream-transcription HTTP/2 host: transcribestreaming.{{us-west-2}}.amazonaws.com X-Amz-Target: com.amazonaws.transcribe.Transcribe.{{StartStreamTranscription}} Content-Type: application/vnd.amazon.eventstream X-Amz-Content-Sha256: {{string}} X-Amz-Date: {{20220208}}T{{235959}}Z Authorization: AWS4-HMAC-SHA256 Credential={{access-key}}/{{20220208}}/{{us-west-2}}/transcribe/aws4_request, SignedHeaders=content-type;host;x-amz-content-sha256;x-amz-date;x-amz-target;x-amz-security-token, Signature={{string}} x-amzn-transcribe-language-code: {{en-US}} x-amzn-transcribe-media-encoding: {{flac}} x-amzn-transcribe-sample-rate: {{16000}} x-amzn-transcribe-vocabulary-name: {{my-first-vocabulary}} transfer-encoding: chunked ``` As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html). Os parâmetros comuns a todas as operações de API da AWS estão listados na seção [Common Parameters](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). ### Fluxo do WebSocket Este exemplo cria um URL pré-assinado que aplica seu vocabulário personalizado a um fluxo do WebSocket. Quebras de linha foram adicionadas para uma melhor leitura. Para obter mais informações sobre como usar fluxos do WebSocket com o Amazon Transcribe, consulte [Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket). Para obter mais detalhes sobre os parâmetros, consulte [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_streaming_StartStreamTranscription.html). ``` GET wss://transcribestreaming.{{us-west-2}}.amazonaws.com:8443/stream-transcription-websocket? &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential={{AKIAIOSFODNN7EXAMPLE}}%2F{{20220208}}%2F{{us-west-2}}%2F{{transcribe}}%2Faws4_request &X-Amz-Date={{20220208}}T{{235959}}Z &X-Amz-Expires={{300}} &X-Amz-Security-Token={{security-token}} &X-Amz-Signature={{string}} &X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date &language-code={{en-US}} &media-encoding={{flac}} &sample-rate={{16000}} &vocabulary-name={{my-first-vocabulary}} ``` As definições de parâmetros podem ser encontradas na [Referência da API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html). Os parâmetros comuns a todas as operações de API da AWS estão listados na seção [Common Parameters](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).