Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Inicio y detención de la transcripción en vivo de Amazon Chime SDK
<a name="initiate-transcription"></a>

Utilice la 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) de Amazon Chime SDK para iniciar la transcripción de la reunión aplicando un `TranscriptionConfiguration` a la reunión. El controlador de Amazon Chime SDK reenvía la configuración a la reunión de forma asíncrona. El éxito o el fracaso de la transcripción de la reunión se indica mediante un mensaje a través de Amazon Simple Notification Service (Amazon SNS) y Amazon. EventBridge

**Iniciar una transcripción**  
En este ejemplo se muestra cómo iniciar una transcripción en directo con 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"
        }
    }
}
```

En este ejemplo se muestra cómo iniciar la transcripción en directo con 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 la transcripción de la reunión.  
`meetingId`: el ID de la reunión, devuelto por la [API CreateMeeting](https://docs.aws.amazon.com/chime-sdk/latest/APIReference/API_CreateMeeting.html#API_CreateMeeting_ResponseSyntax).  
`TranscriptionConfiguration`: encapsula los parámetros de la transcripción en directo. Debe especificar exactamente una configuración, `EngineTranscribeSettings` o `EngineTranscribeMedicalSettings`.

`EngineTranscribeSettings`: especifica el uso de Amazon Transcribe y transfiere su configuración a [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`: obligatorio.  
`VocabularyFilterMethod`: opcional.  
`VocabularyFilterName`: opcional.  
`VocabularyName`: opcional.  
`Region`: opcional.  
`EnablePartialResultsStabilization`: opcional.  
`PartialResultsStability`: opcional.  
` ContentIdentificationType`: opcional.  
`ContentRedactionType`: opcional.  
`PiiEntityTypes `: opcional.  
`LanguageModelName`: opcional.

`EngineTranscribeMedicalSettings`: especifica el uso de Amazon Transcribe Medical y transfiere su configuración a [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`: obligatorio.  
`Speciality`: obligatorio.  
`Type`: obligatorio.  
`VocabularyName`: opcional.  
`Region`: opcional.  
` ContentIdentificationType`: opcional.

**Respuestas**  
Amazon Transcribe y Amazon Transcribe Medical responden a las siguientes preguntas:
+ `OK` (200) con el cuerpo vacío, si lo aplica correctamente `TranscriptionConfiguration` a la reunión.

**Mensajes de error**  
Amazon Transcribe y Amazon Transcribe Medical muestran los siguientes mensajes de error:
+ **BadRequestException (400):** Los parámetros de entrada no coinciden con las restricciones del servicio.
+ **ForbiddenException (403):** El cliente tiene prohibido permanentemente realizar la solicitud.
+ **NotFoundException (404):** `meetingId` No existe.
+ **ResourceLimitExceededException (400):** La solicitud supera el límite de recursos. Por ejemplo, demasiadas reuniones tienen habilitada la transcripción en directo.
+ **ServiceFailureException (500):** El servicio detectó un error inesperado.
+ **ServiceUnavailableException (503):** El servicio no está disponible en este momento.
+ **ThrottledClientException (429):** El cliente superó el límite de frecuencia de solicitudes.
+ **UnauthorizedClientException (401):** El cliente no está autorizado actualmente a realizar la solicitud.

Si se llama a `StartMeetingTranscription` por segunda vez, se actualiza el `TranscriptionConfiguration` aplicado a la reunión.

**Detener una transcripción**  
Utilice la 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 eliminar la `TranscriptionConfiguration` de una `meetingID` determinada y finalizar la transcripción de la reunión. Al finalizar una reunión, se detiene la transcripción automáticamente.

En este ejemplo se muestra la sintaxis de solicitud que invoca `StopMeetingTranscription`.

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

**Respuestas**  
Amazon Transcribe y Amazon Transcribe Medical responden a las siguientes preguntas:
+ `OK` (200) con el cuerpo vacío, si elimina correctamente el `TranscriptionConfiguration` de la reunión.

**Mensajes de error**  
Amazon Transcribe y Amazon Transcribe Medical muestran los siguientes mensajes de error:
+ **BadRequestException (400):** Los parámetros de entrada no coinciden con las restricciones del servicio.
+ **ForbiddenException (403):** El cliente tiene prohibido permanentemente realizar la solicitud.
+ **NotFoundException (404):** `meetingId` No existe.
+ **ServiceFailureException (500):** El servicio detectó un error inesperado.
+ **ServiceUnavailableException (503):** El servicio no está disponible en este momento.
+ **ThrottledClientException (429):** El cliente superó el límite de frecuencia de solicitudes.
+ **UnauthorizedClientException (401):** El cliente no está autorizado actualmente a realizar la solicitud.