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

# Iniciar e interromper a transcrição ao vivo do SDK do Amazon Chime
<a name="initiate-transcription"></a>

Use a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_StartMeetingTranscription.html) do SDK do Amazon Chime para iniciar a transcrição da reunião aplicando uma `TranscriptionConfiguration` à reunião. O controlador do SDK do Amazon Chime encaminha a configuração para a reunião de forma assíncrona. O sucesso ou o fracasso de iniciar a transcrição da reunião é sinalizado por meio de uma mensagem via Amazon Simple Notification Service (Amazon SNS) e Amazon. EventBridge

**Como iniciar a transcrição**  
Este exemplo de mostra como iniciar a transcrição ao vivo com o Amazon Transcribe.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{
    "TranscriptionConfiguration": {
        "EngineTranscribeSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "en-US",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_ResponseSyntax)": "tag",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "profanity",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "lingo",
            "Region": "us-east-1"
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": true,  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "high",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "PII",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "ALL",  
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestSyntax)": "language-model"
        }
    }
}
```

Este exemplo de mostra como iniciar a transcrição ao vivo com o Amazon Transcribe Medical.

```
POST /meetings/meetingId/transcription?operation=start HTTP/1.1 
Content-type: application/json
{  
    "TranscriptionConfiguration": {
        "EngineTranscribeMedicalSettings": {
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "en-US",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PRIMARYCARE",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "CONVERSATION",
            "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "lingo",
            "Region": "us-east-1",
           "[https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html)": "PHI", 
        }
   }
}
```

`StartMeetingTranscription`: inicia a transcrição da reunião.  
`meetingId`: o ID da reunião, exibido pela [API CreateMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax).  
`TranscriptionConfiguration`: encapsula os parâmetros para a transcrição ao vivo. Você deve especificar exatamente uma configuração, `EngineTranscribeSettings` ou `EngineTranscribeMedicalSettings`.

`EngineTranscribeSettings`: especifica o uso do Amazon Transcribe e transmite suas configurações ao [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartStreamTranscription.html#API_streaming_StartStreamTranscription_RequestParameters).  
`LanguageCode` – obrigatório.  
`VocabularyFilterMethod`: opcional.  
`VocabularyFilterName`: opcional.  
`VocabularyName`: opcional.  
`Region`: opcional.  
`EnablePartialResultsStabilization`: opcional.  
`PartialResultsStability`: opcional.  
` ContentIdentificationType`: opcional.  
`ContentRedactionType`: opcional.  
`PiiEntityTypes `: opcional.  
`LanguageModelName`: opcional.

`EngineTranscribeMedicalSettings`: especifica o uso do Amazon Transcribe Medical e transmite suas configurações ao [https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters](https://docs.aws.amazon.com/transcribe/latest/dg/API_streaming_StartMedicalStreamTranscription.html#API_streaming_StartMedicalStreamTranscription_RequestParameters).   
`LanguageCode` – obrigatório.  
`Speciality` – obrigatório.  
`Type` – obrigatório.  
`VocabularyName`: opcional.  
`Region`: opcional.  
` ContentIdentificationType`: opcional.

**Respostas**  
O Amazon Transcribe e o Amazon Transcribe Medical recebem as seguintes respostas:
+ `OK` (200) com corpo vazio, se você aplicar com sucesso o `TranscriptionConfiguration` à reunião.

**Mensagens de erro**  
O Amazon Transcribe e o Amazon Transcribe Medical recebem as seguintes mensagens de erro:
+ **BadRequestException (400):** Os parâmetros de entrada não correspondem às restrições do serviço.
+ **ForbiddenException (403):** O cliente está permanentemente proibido de fazer a solicitação.
+ **NotFoundException (404):** O `meetingId` não existe.
+ **ResourceLimitExceededException (400):** A solicitação excede o limite de recursos. Por exemplo, muitas reuniões têm a transcrição ao vivo ativada.
+ **ServiceFailureException (500):** O serviço encontrou um erro inesperado.
+ **ServiceUnavailableException (503):** O serviço não está disponível no momento.
+ **ThrottledClientException (429):** O cliente excedeu seu limite de taxa de solicitação.
+ **UnauthorizedClientException (401):** O cliente não está atualmente autorizado a fazer a solicitação.

Chamar `StartMeetingTranscription` pela segunda vez atualiza a `TranscriptionConfiguration` aplicada à reunião.

**Como interromper a transcrição**  
Use a API [https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_meeting-chime_StopMeetingTranscription.html) para remover a `TranscriptionConfiguration` para um `meetingID` específico e finalizar a transcrição da reunião. O encerramento de uma reunião interrompe a transcrição automaticamente.

Este exemplo mostra a sintaxe da solicitação que invoca a `StopMeetingTranscription`.

```
POST/meetings/meetingId/transcription?operation=stop HTTP/1.1
```

**Respostas**  
O Amazon Transcribe e o Amazon Transcribe Medical recebem as seguintes respostas:
+ `OK` (200) com corpo vazio, se você remover com sucesso a `TranscriptionConfiguration` da reunião.

**Mensagens de erro**  
O Amazon Transcribe e o Amazon Transcribe Medical recebem as seguintes mensagens de erro:
+ **BadRequestException (400):** Os parâmetros de entrada não correspondem às restrições do serviço.
+ **ForbiddenException (403):** O cliente está permanentemente proibido de fazer a solicitação.
+ **NotFoundException (404):** O `meetingId` não existe.
+ **ServiceFailureException (500):** O serviço encontrou um erro inesperado.
+ **ServiceUnavailableException (503):** O serviço não está disponível no momento.
+ **ThrottledClientException (429):** O cliente excedeu seu limite de taxa de solicitação.
+ **UnauthorizedClientException (401):** O cliente não está atualmente autorizado a fazer a solicitação.