Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Amazon Transcribe prend en charge le protocole HTTP pour les transcriptions par lots (HTTP/1.1) et en streaming (HTTP/2). WebSockets sont pris en charge pour les transcriptions en streaming.

Si vous transcrivez un fichier multimédia situé dans un Amazon S3 bucket, vous effectuez une transcription par lots. Si vous transcrivez un flux de données audio en temps réel, vous effectuez une transcription en streaming.

HTTP et WebSockets exigent que vous authentifiiez votre demande à l'aide des en-têtes AWS Signature Version 4. Reportez-vous à [la section Signing des demandes d' AWS API](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html) pour plus d'informations.

## Transcription par lots
<a name="getting-started-http-batch"></a>

Vous pouvez effectuer une requête HTTP par lots à l’aide des en-têtes suivants :
+ hôte
+ x-amz-target
+ content-type
+ x-amz-content-sha256
+ x-amz-date
+ autorisation

Voici un exemple de demande `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/" 
}
```

Les opérations et paramètres supplémentaires sont répertoriés dans la [référence d'API](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) ; les paramètres communs à toutes les opérations d' AWS API sont répertoriés dans la section [Paramètres communs](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html). Les autres éléments de signature sont détaillés dans [la section Éléments d'une demande de AWS signature version 4](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html).

## Transcriptions en streaming
<a name="getting-started-http-streaming"></a>

Les transcriptions en streaming utilisant HTTP/2 WebSockets sont plus complexes que leur utilisation. SDKs Nous vous recommandons de consulter la section [Configuration d’une transcription en streaming](streaming-setting-up.md) avant de configurer votre premier flux.

Pour plus d’informations sur ces méthodes, consultez la section [Configuration d’un flux HTTP/2](streaming-setting-up.md#streaming-http2) ou [Configuration d'un WebSocket stream](streaming-setting-up.md#streaming-websocket).

**Note**  
Nous vous recommandons vivement d’utiliser un kit SDK pour les transcriptions en streaming. Pour obtenir la liste des produits pris en charge SDKs, reportez-vous à[Langages de programmation pris en charge](supported-languages.md#supported-sdks).