HTTP による文字起こしまたは WebSockets

Amazon Transcribeバッチ (HTTP/1.1) とストリーミング (HTTP/2) の両方のトランスクリプションで HTTP をサポートします。 WebSockets ストリーミング文字変換がサポートされています。

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

どちらも HTTP で WebSockets 、AWS署名バージョン 4 ヘッダーを使用してリクエストを認証する必要があります。詳細については、「AWSAPI リクエストへの署名」を参照してください。

Batch 文字起こし

次のヘッダーを使用してバッチ HTTP リクエストを作成できます。

• host

• x-amz-target

• コンテンツタイプ

• 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://DOC-EXAMPLE-BUCKET/my-input-files/my-media-file.flac"
    },
    "OutputBucketName": "DOC-EXAMPLE-BUCKET",
    "OutputKey": "my-output-files/" 
}

その他の操作とパラメータは「API リファレンス」に、すべてのAWS API 操作に共通するパラメータは「共通パラメータ」セクションに記載されています。その他の署名要素については、「AWS署名バージョン 4 リクエストの要素」で詳しく説明しています。

ストリーミングトランスクリプション

HTTP/2 WebSockets を使用して文字起こしをストリーミングしますが、SDK を使用するよりも複雑です。最初のストリームを設定する前に、ストリーミングトランスクリプションのセットアップこのセクションを確認することをお勧めします。

これらの方法の詳細については、HTTP/2 ストリームの設定またはを参照してくださいのセットアップ WebSocket ストリーム。

注記

音声文字変換のストリーミングには SDK を使用することを強くお勧めします。サポートされている SDK のリストについては、を参照してくださいサポートされているプログラミング言語。