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

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

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

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

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

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

次のヘッダーを使用してバッチ 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 のリストについては、を参照してくださいサポートされているプログラミング言語。