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.

# Transcribir con HTTP o WebSockets
<a name="getting-started-http-websocket"></a>

Amazon Transcribe admite HTTP tanto para las transcripciones por lotes (HTTP/1.1) como para las de streaming (HTTP/2). WebSockets son compatibles con la transmisión de transcripciones.

Si está transcribiendo un archivo multimedia ubicado en un Amazon S3 depósito, está realizando una transcripción por lotes. Si está transcribiendo una transmisión de datos de audio en tiempo real, está realizando una transcripción en streaming.

Tanto HTTP como yo WebSockets requieren que autentiques tu solicitud mediante los encabezados de la versión 4 de AWS Signature. Consulta la sección [Firmar solicitudes a AWS la API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) para obtener más información.

## Transcripciones por lotes
<a name="getting-started-http-batch"></a>

Puede realizar una solicitud HTTP por lotes utilizando los siguientes encabezados:
+ host
+ x-amz-target
+ content-type
+ x-amz-content-sha256
+ x-amz-date
+ authorization

A continuación se muestra un ejemplo de la solicitud `StartTranscriptionJob`:

```
POST /transcribe HTTP/1.1 
host: transcribe.{{us-west-2}}.amazonaws.com
x-amz-target: com.amazonaws.transcribe.Transcribe.{{StartTranscriptionJob}} 
content-type: application/x-amz-json-1.1
x-amz-content-sha256: {{string}}
x-amz-date: {{YYYYMMDD}}T{{HHMMSS}}Z
authorization: AWS4-HMAC-SHA256 Credential={{access-key}}/{{YYYYMMSS}}/{{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}}

{
    "TranscriptionJobName": "{{my-first-transcription-job}}",
    "LanguageCode": "{{en-US}}",
    "Media": {
        "MediaFileUri": "s3://{{amzn-s3-demo-bucket}}/{{my-input-files}}/{{my-media-file}}.{{flac}}"
    },
    "OutputBucketName": "{{amzn-s3-demo-bucket}}",
    "OutputKey": "{{my-output-files}}/" 
}
```

Las operaciones y los parámetros adicionales se enumeran en la [referencia de la API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html); los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección [Parámetros comunes](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). Otros elementos de firma se detallan en la [solicitud de la versión 4 de Elementos de una AWS firma](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html).

## Transcripciones de streaming
<a name="getting-started-http-streaming"></a>

El streaming de HTTP/2 transcripciones WebSockets es más complicado que el uso de SDK. Le recomendamos que revise la sección [Configuración de una transcripción de streaming](streaming-setting-up.md) antes de configurar su primera transmisión.

Para obtener más información sobre estos métodos, consulte [Configurar una HTTP/2 transmisión](streaming-setting-up.md#streaming-http2) o[Configuración de una WebSocket transmisión](streaming-setting-up.md#streaming-websocket).

**nota**  
Recomendamos encarecidamente utilizar un SDK para las transcripciones de streaming. Para obtener una lista de los SDK admitidos, consulte [Lenguajes de programación admitidos](supported-languages.md#supported-sdks).