

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

# Transcrevendo com HTTP ou WebSockets
<a name="getting-started-http-websocket"></a>

Amazon Transcribe suporta HTTP para transcrições em lote (HTTP/1.1) e streaming (HTTP/2). WebSockets são compatíveis com transcrições de streaming.

Se você estiver transcrevendo um arquivo de mídia localizado em um Amazon S3 bucket, você está realizando uma transcrição em lote. Se estiver transcrevendo um streaming de dados de áudio em tempo real, isso significa que você está realizando uma transcrição de streaming.

Tanto o HTTP quanto o HTTP WebSockets exigem que você autentique sua solicitação usando os cabeçalhos AWS Signature Version 4. Consulte [Solicitações AWS da API de assinatura](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) para obter mais informações.

## Transcrições em lote
<a name="getting-started-http-batch"></a>

Você pode fazer uma solicitação HTTP em lote usando os seguintes cabeçalhos:
+ host
+ x-amz-target
+ content-type
+ x-amz-content-sha256
+ x-amz-date
+ autorização

Veja um exemplo de uma solicitação `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/" 
}
```

Operações e parâmetros adicionais estão listados 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). Outros elementos de assinatura estão detalhados em [Elementos de uma solicitação de AWS assinatura versão 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html).

## Transcrições de streaming
<a name="getting-started-http-streaming"></a>

Transcrições de streaming usando HTTP/2 WebSockets são mais envolventes do que usando. SDKs Recomendamos revisar a seção [Configurar uma transcrição de streaming](streaming-setting-up.md) antes de configurar sua primeira transmissão.

Para obter mais informações sobre esses métodos, consulte [Configurar um fluxo de HTTP/2](streaming-setting-up.md#streaming-http2) ou [Configurando um WebSocket stream](streaming-setting-up.md#streaming-websocket).

**nota**  
É altamente recomendável usar um SDK para transcrições de streaming. Para obter uma lista dos compatíveis SDKs, consulte[Linguagens de programação compatíveis](supported-languages.md#supported-sdks).