翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# HTTP または WebSocket による文字起こし
<a name="getting-started-http-websocket"></a>

Amazon Transcribe は、バッチ (HTTP/1.1) 文字起こしとストリーミング (HTTP/2) 文字起こしの両方で HTTP をサポートします。WebSocket はストリーミング文字起こしに対応しています。

 Amazon S3 バケットにあるメディアファイルを文字起こしする場合は、バッチ文字起こしを実行します。音声データのリアルタイムストリームを文字起こしする場合は、ストリーミング文字起こしを実行していることになります。

HTTP と WebSocket はどちらも、 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 リクエストを行うことができます。
+ ホスト
+ 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: 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/" 
}
```

追加のオペレーションとパラメータは [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>

HTTP/2 と WebSocket を使ったストリーミング文字起こしは、SDK を使用するよりも複雑です。最初のストリームを設定する前に、[ストリーミング文字起こしの設定](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)」を参照してください。