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

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

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

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

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

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

以下のヘッダーを使用して、バッチ 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 リファレンスに記載されています。すべての AWS API オペレーションに共通のパラメータは、「共通パラメータ」セクションに記載されています。その他の署名要素は、AWS 署名バージョン 4 リクエストの要素で詳しく説明されています。

HTTP/2 と WebSocket を使ったストリーミング文字起こしは、SDK を使用するよりも複雑です。最初のストリームを設定する前に、ストリーミング文字起こしの設定 セクションを確認することをおすすめします。

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

注記

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