本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 HTTP 或 WebSockets 進行轉錄
<a name="getting-started-http-websocket"></a>

Amazon Transcribe 支援批次 (HTTP/1.1) 和串流 (HTTP/2) 轉錄的 HTTP。WebSockets 支援串流轉錄。

如果您要轉錄位於 Amazon S3 儲存貯體中的媒體檔案，則您要執行批次轉錄。如果您要轉錄音訊資料的即時串流，您要執行的是串流轉錄。

HTTP 和 WebSockets 都要求您使用 AWS Signature 第 4 版標頭以驗證您的請求。如需詳細資訊，請參閱[簽署 AWS API 請求](https://docs.aws.amazon.com/general/latest/gr/signing_aws_api_requests.html)。

## 批次轉錄
<a name="getting-started-http-batch"></a>

您可以使用下列標頭提出批次 HTTP 要求：
+ 託管
+ 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 參考](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_Reference.html)中；所有 AWS API 操作常用的參數會列在[通用參數](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>

與使用 SDK 相較，使用 HTTP/2 和 WebSockets 的串流轉錄更深入。我們建議您在設定第一個串流前，先查看 [設定串流轉錄](streaming-setting-up.md) 一節。

如需這些方法的詳細資訊，請參閱 [設定 HTTP/2 串流](streaming-setting-up.md#streaming-http2) 或 [設定 WebSocket 串流](streaming-setting-up.md#streaming-websocket)。

**注意**  
我們強烈建議您使用 SDK 進行串流轉錄。如需支援的 SDK 清單，請參閱 [支援的程式設計語言](supported-languages.md#supported-sdks)。