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 filtro de vocabulário personalizado Depois que o filtro de vocabulário personalizado for criado, você poderá incluí-lo nas solicitações de transcrição. Consulte as seções a seguir para ver exemplos. O idioma do filtro de vocabulário personalizado que você está incluindo na solicitação deve corresponder ao código de idioma especificado para a mídia. Se você usar a identificação de idioma e especificar várias opções de idioma, poderá incluir um filtro de vocabulário personalizado por idioma especificado. Se os idiomas dos filtros de vocabulário personalizado não corresponderem ao idioma identificado no áudio, os filtros não serão aplicados à transcrição e não haverá avisos ou erros. ## Usar um filtro de vocabulário personalizado em uma transcrição em lote Para usar um filtro de 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**. ![Amazon Transcribe captura de tela do console: a página “especificar configurações de trabalho”.](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 página **Configurar tarefa**, no painel **Remoção de conteúdo**, ative **Filtragem de vocabulário**. ![Amazon Transcribe captura de tela do console: a página 'configurar trabalho'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/console-batch-configure-job-vocab-filter.png) 1. Selecione o filtro de vocabulário personalizado no menu suspenso e especifique o método de filtragem. ![Amazon Transcribe captura de tela do console: opções de seleção de filtro de vocabulário.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/console-batch-vocab-filter-method.png) 1. 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 os subparâmetros `VocabularyFilterName` e `VocabularyFilterMethod`. 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 VocabularyFilterName={{my-first-vocabulary-filter}},VocabularyFilterMethod={{mask}} ``` 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 o filtro de vocabulário personalizado com esse trabalho. ``` aws transcribe start-transcription-job \ --region {{us-west-2}} \ --cli-input-json file://{{my-first-vocabulary-filter-job}}.json ``` O arquivo *my-first-vocabulary-filter-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": { "VocabularyFilterName": "{{my-first-vocabulary-filter}}", "VocabularyFilterMethod": "{{mask}}" } } ``` ### AWS SDK para Python (Boto3) Este exemplo usa o AWS SDK para Python (Boto3) para incluir um filtro de vocabulário personalizado usando o `Settings` argumento do 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 AWS SDKs, incluindo 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 = { 'VocabularyFilterName': '{{my-first-vocabulary-filter}}', 'VocabularyFilterMethod': '{{mask}}' } ) 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 filtro de vocabulário personalizado em uma transcrição de streaming Para usar um filtro de 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 **Real-time transcrição**. Role para baixo até **Configurações de remoção de conteúdo** e expanda esse campo se ele estiver minimizado. ![Amazon Transcribe captura de tela do console: a página de 'transcrição em tempo real'.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/stream-main.png) 1. Ative **Filtragem de vocabulário**. Selecione um filtro de vocabulário personalizado no menu suspenso e especifique o método de filtragem. ![Amazon Transcribe captura de tela do console: o painel expandido de “configurações de remoção de conteúdo”.](http://docs.aws.amazon.com/pt_br/transcribe/latest/dg/images/vocab-filter-stream.png) Inclua outras configurações que deseja aplicar ao 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**. ### HTTP/2 stream Este exemplo cria uma HTTP/2 solicitação que inclui seu filtro de vocabulário e método de filtro personalizados. Para obter mais informações sobre como usar o HTTP/2 streaming com Amazon Transcribe, consulte[Configurando um HTTP/2 stream](streaming-setting-up.md#streaming-http2). Para obter mais detalhes sobre parâmetros e cabeçalhos específicos de 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-filter-name: {{my-first-vocabulary-filter}} x-amzn-transcribe-vocabulary-filter-method: {{mask}} 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 AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). ### WebSocket stream Este exemplo cria um URL pré-assinado que aplica seu filtro de vocabulário personalizado a um WebSocket stream. Quebras de linha foram adicionadas para uma melhor leitura. Para obter mais informações sobre o uso de WebSocket fluxos com 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-filter-name={{my-first-vocabulary-filter}} &vocabulary-filter-method={{mask}} ``` 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 AWS da API estão listados na seção [Parâmetros comuns](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html).