本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 HTTP 进行转录或 WebSockets
<a name="getting-started-http-websocket"></a>

Amazon Transcribe 支持批处理 (HTTP/1.1) 和流式传输 (HTTP/2) 转录的 HTTP。 WebSockets 支持直播转录。

如果您要转录 Amazon S3 存储桶中的媒体文件，则是在执行批量转录。如果您要转录音频数据的实时流，则将执行流式转录。

HTTP 和都 WebSockets 要求您使用 AWS 签名版本 4 标头对请求进行身份验证。有关更多信息，请参阅[签署 AWS API 请求](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)。

## 批量转录
<a name="getting-started-http-batch"></a>

您可以使用以下标头发出批量 HTTP 转录请求：
+ host
+ x-amz-target
+ content-type
+ x-amz-content-sha256
+ x-amz-date
+ 授权

`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}}/" 
}
```

[API 参考中列出了其他操作和参数；所有 AWS AP](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html) I 操作的通用参数列在 “[常用参数](https://docs.aws.amazon.com/transcribe/latest/APIReference/CommonParameters.html)” 部分。其他签名元素详见[AWS 签名版本 4 请求的要](https://docs.aws.amazon.com/general/latest/gr/sigv4_elements.html)素。

## 流式转录
<a name="getting-started-http-streaming"></a>

使用 HTTP/2 流式传输转录比使用更 WebSockets 复杂。 SDKs我们建议您在设置第一个流之前查看[设置流式转录](streaming-setting-up.md)部分。

有关这些方法的更多信息，请参阅[设置 HTTP/2 音频流](streaming-setting-up.md#streaming-http2)或[设置直 WebSocket 播](streaming-setting-up.md#streaming-websocket)。

**注意**  
我们强烈建议使用 SDK 进行流式转录。有关支持的列表 SDKs，请参阅[支持的编程语言](supported-languages.md#supported-sdks)。