View a markdown version of this page

Transcribir con HTTP o WebSockets - Amazon Transcribe

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

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 para obtener más información.

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: YYYYMMDDTHHMMSSZ
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; los parámetros comunes a todas las operaciones de la AWS API se enumeran en la sección Parámetros comunes. Otros elementos de firma se detallan en la solicitud de la versión 4 de Elementos de una AWS firma.

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 antes de configurar su primera transmisión.

Para obtener más información sobre estos métodos, consulte Configurar una HTTP/2 transmisión oConfiguración de una WebSocket transmisión.

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.