ストリーミング文字起こしの設定

リクエストを行う IAM ロールに次のポリシーをアタッチします。詳細については、IAM 「ポリシーの追加」を参照してください。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "my-transcribe-http2-policy",
            "Effect": "Allow",
            "Action": "transcribe:StartStreamTranscription",
            "Resource": "*"
        }
    ]
}

セッションを開始するには、HTTP/2 リクエストを送信します Amazon Transcribe。

POST /stream-transcription HTTP/2
host: transcribestreaming.us-west-2.amazonaws.com
X-Amz-Target: com.amazonaws.transcribe.Transcribe.StartStreamTranscription
Content-Type: application/vnd.amazon.eventstream
X-Amz-Content-Sha256: string
X-Amz-Date: YYYYMMDDTHHMMSSZ
Authorization: AWS4-HMAC-SHA256 Credential=access-key/YYYYMMDD/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
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
transfer-encoding: chunked

追加のオペレーションとパラメータはAPIリファレンスにリストされています。すべての AWS APIオペレーションに共通のパラメータは共通パラメータセクションにリストされています。

Amazon Transcribe は次のレスポンスを送信します。

HTTP/2.0 200
x-amzn-transcribe-language-code: en-US
x-amzn-transcribe-media-encoding: flac
x-amzn-transcribe-sample-rate: 16000
x-amzn-request-id: 8a08df7d-5998-48bf-a303-484355b4ab4e
x-amzn-transcribe-session-id: b4526fcf-5eee-4361-8192-d1cb9e9d6887
content-type: application/json

音声データを含む音声イベントを作成します。以下の表に示すヘッダを、イベントエンコードされたメッセージの音声バイトのチャンクと組み合わせます。イベントメッセージのペイロードを作成するには、raw バイト形式のバッファを使用します。

このリクエスト例のバイナリデータは base64 でエンコードされています。実際のリクエストでは、データはローバイトです。

:content-type: "application/vnd.amazon.eventstream"
:event-type: "AudioEvent"
:message-type: "event"
UklGRjzxPQBXQVZFZm10IBAAAAABAAEAgD4AAAB9AAACABAAZGF0YVTwPQAAAAAAAAAAAAAAAAD//wIA/f8EAA==

音声データを含む音声メッセージを作成します。

1. 音声メッセージデータフレームには、現在の日付と、音声チャンクと音声ベントの署名を含むイベントエンコードのヘッダーが含まれます。

   ヘッダー名のバイト長	ヘッダー名 (文字列)	ヘッダー値の型	値の文字列のバイト長	値
   16	: チャンク署名	6	可変	生成された署名
   5	: 日付	8	8	タイムスタンプ

   このリクエストのバイナリデータは base64 でエンコードされています。実際のリクエストでは、データはローバイトです。

   :date: 2019-01-29T01:56:17.291Z
   :chunk-signature: signature
   
   AAAA0gAAAIKVoRFcTTcjb250ZW50LXR5cGUHABhhcHBsaWNhdGlvbi9vY3RldC1zdHJlYW0LOmV2ZW50LXR5
   cGUHAApBdWRpb0V2ZW50DTptZXNzYWdlLXR5cGUHAAVldmVudAxDb256ZW50LVR5cGUHABphcHBsaWNhdGlv
   bi94LWFtei1qc29uLTEuMVJJRkY88T0AV0FWRWZtdCAQAAAAAQABAIA+AAAAfQAAAgAQAGRhdGFU8D0AAAAA
   AAAAAAAAAAAA//8CAP3/BAC7QLFf

2. 「署名バージョン 4 の署名文字列を作成する」に従って、署名文字列を作成します。文字列は次の形式に従います。

   String stringToSign =
   "AWS4-HMAC-SHA256" +
   "\n" +
   DateTime +
   "\n" +
   Keypath +
   "\n" +
   Hex(priorSignature) +
   "\n" +
   HexHash(nonSignatureHeaders) +
   "\n" +
   HexHash(payload);

   • DateTime: 署名が作成された日時。形式は です。ここでYYYYMMDDTHHMMSSZ、YYYY=year、MM=month、DD=day、HH=hour、MM=minute、SS=seconds、'T' と 'Z' は固定文字です。詳細については、「署名バージョン 4 で日付を扱う」を参照してください。

   • Keypath: date/region/service/aws4_request 形式の署名範囲。例えば、20220127/us-west-2/transcribe/aws4_request と指定します。

   • Hex: 入力を 16 進数にエンコードする関数。

   • priorSignature: 前回のフレームの署名。最初のデータフレームで、ヘッダーフレームの署名を使用します。

   • HexHash: 最初に入力の SHA-256 ハッシュを作成し、次に Hex 関数を使用してハッシュをエンコードする関数。

   • nonSignatureHeaders: 文字列としてエンコードされた DateTime ヘッダー。

   • payload: 音声イベントデータを含むバイトバッファ。

3. AWS シークレットアクセスキーから署名キーを取得し、それを使用して に署名しますstringToSign。保護レベルを高めるために、派生キーは日付、サービス、 AWS リージョンに固有になっています。詳細については、「AWS署名バージョン 4 の署名を計算する」を参照してください。

   GetSignatureKey 関数を実装して署名キーを取得します。まだ署名キーを取得していない場合は、「署名バージョン 4 の署名キーを取得する方法の例」を参照してください。

   String signature = HMACSHA256(derivedSigningKey, stringToSign);

   • HMACSHA256: SHA-256 ハッシュ関数を使用して署名を作成する関数。

   • derivedSigningKey: 署名バージョン 4 の署名キー。

   • stringToSign: データフレームに対して計算した文字列。

   データフレームの署名を計算したら、日付、署名、および音声イベントペイロードを含むバイトバッファを構築します。文字起こし用にバイト配列を Amazon Transcribe に送信します。

音声ストリームが完了したことを示すには、日付と署名のみを含む空のデータ終了フレームを送信します。データフレームを構築するのと同じ方法で、この終了フレームを構築します。

Amazon Transcribe は、アプリケーションに送信される文字起こしイベントのストリームで応答します。このレスポンスはイベントストリームでエンコードされます。また、標準の prelude と以下のヘッダーが含まれます。

イベントは、ローバイトの形式で送信されます。この例では、バイトは base64 でエンコードされています。

AAAAUwAAAEP1RHpYBTpkYXRlCAAAAWiXUkMLEDpjaHVuay1zaWduYXR1cmUGACCt6Zy+uymwEK2SrLp/zVBI
5eGn83jdBwCaRUBJA+eaDafqjqI=

文字起こし結果を表示するには、イベントストリームのエンコードを使用してローバイトをデコードします。

:content-type: "application/vnd.amazon.eventstream"
:event-type: "TranscriptEvent"
:message-type: "event"

{
    "Transcript":
        {
            "Results":
                [
                    results
                ]
        }
}

ストリームを終了するには、空の音声イベントを Amazon Transcribeに送信します。他の音声イベントとまったく同じように音声イベントを作成します (空のペイロードは除く)。イベントに署名し、その署名を :chunk-signature ヘッダーに含めます。以下に手順を示します。

:date: 2019-01-29T01:56:17.291Z
:chunk-signature: signature

リクエストを行う IAM ロールに次のポリシーをアタッチします。詳細については、IAM 「ポリシーの追加」を参照してください。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "my-transcribe-websocket-policy",
            "Effect": "Allow",
            "Action": "transcribe:StartStreamTranscriptionWebSocket",
            "Resource": "*"
        }
    ]
}

セッションを開始するには、URL次の形式で署名付き を作成します。読みやすくするために、改行が追加されています。

GET wss://transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=access-key%2FYYYYMMDD%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=YYYYMMDDTHHMMSSZ
&X-Amz-Expires=300
&X-Amz-Security-Token=security-token
&X-Amz-Signature=string
&X-Amz-SignedHeaders=content-type%3Bhost%3Bx-amz-date
&language-code=en-US
&media-encoding=flac
&sample-rate=16000

追加のオペレーションとパラメータはAPIリファレンスにリストされています。すべての AWS APIオペレーションに共通のパラメータは共通パラメータセクションにリストされています。

リクエストURLの を構築し、署名バージョン 4 の署名を作成するには、次のステップを参照してください。例は擬似コードで示しています。

1. 正規リクエストを作成します。正規は、リクエストからの情報を標準化された形式で含む文字列です。これにより、 がリクエスト AWS を受け取ると、 用に作成したのと同じ署名を計算できますURL。詳細については、「署名バージョン 4 の正規リクエストを作成する」を参照してください。

   # HTTP verb
   method = "GET"
   # Service name
   service = "transcribe"
   # Region
   region = "us-west-2"
   # Amazon Transcribe streaming endpoint
   endpoint = "wss://transcribestreaming.us-west-2.amazonaws.com:8443"
   # Host
   host = "transcribestreaming.us-west-2.amazonaws.com:8443"
   # Date and time of request
   amz-date = YYYYMMDDTHHMMSSZ
   # Date without time for credential scope
   datestamp = YYYYMMDD

2. ドメインとクエリ文字列URIの間の の一部URIである正規 を作成します。

   canonical_uri = "/stream-transcription-websocket"

3. 正規ヘッダーと署名付きヘッダーを作成します。正規ヘッダーの末尾の \n に注意してください。

   • 小文字のヘッダー名とそれに続くコロン ( : ) を追加します。

   • このヘッダーの値のカンマ区切りリストを追加します。複数の値を持つヘッダーの値はソートしません。

   • 改行 (\n) を追加します。

   canonical_headers = "host:" + host + "\n"
   signed_headers = "host"

4. アルゴリズムをハッシュアルゴリズムに一致させます。SHA-256 を使用します。

   algorithm = "AWS4-HMAC-SHA256"

5. 派生キーの範囲を日付、 AWS リージョン、サービスに絞るための認証情報スコープを作成します。例えば、20220127/us-west-2/transcribe/aws4_request と指定します。

   credential_scope = datestamp + "/" + region + "/" + service + "/" + "aws4_request"

6. 正規クエリ文字列を作成します。クエリ文字列値は URIエンコードされ、名前でソートされる必要があります。

   • パラメータ名を文字コードポイントで昇順にソートします。名前が重複しているパラメータは、値でソートする必要があります。たとえば、大文字 F で始まるパラメータ名は、小文字 b で始まるパラメータ名より前に置きます。

   • RFC 3986 で定義されている予約されていない文字をURIエンコードしないでください。A～Z、a～z、0～9、ハイフン (～）、アンダースコア (_)、ピリオド (.)、チルダ (～）。

   • 他のすべての文字についても、%XY によるパーセントエンコードが必要です。X および Y には 16 進数文字 (0～9 および大文字の A～F) が入ります。例えば、スペース文字は %20 としてエンコードする必要があります (一部のエンコードスキームでは「＋」を含めないでください）。拡張 UTF-8 文字は %XY%ZA%BC の形式である必要があります。

   • パラメータ値の等号 (=) 文字を二重エンコードします。

   canonical_querystring  = "X-Amz-Algorithm=" + algorithm
   canonical_querystring += "&X-Amz-Credential="+ URI-encode(access key + "/" + credential_scope)
   canonical_querystring += "&X-Amz-Date=" + amz_date 
   canonical_querystring += "&X-Amz-Expires=300"
   canonical_querystring += "&X-Amz-Security-Token=" + token
   canonical_querystring += "&X-Amz-SignedHeaders=" + signed_headers
   canonical_querystring += "&language-code=en-US&media-encoding=flac&sample-rate=16000"

7. ペイロードのハッシュを作成します。GET リクエストの場合、ペイロードは空の文字列です。

   payload_hash = HashSHA256(("").Encode("utf-8")).HexDigest()

8. 以下の要素を組み合わせて正規リクエストを作成します。

   canonical_request = method + '\n' 
      + canonical_uri + '\n' 
      + canonical_querystring + '\n' 
      + canonical_headers + '\n' 
      + signed_headers + '\n' 
      + payload_hash

リクエストについてのメタ情報が含まれる署名する文字列を作成します。次のステップでリクエストの署名を計算するときに、文字列を使用してサインインします。詳細については、「署名バージョン 4 の署名文字列を作成する」を参照してください。

string_to_sign=algorithm + "\n"
   + amz_date + "\n"
   + credential_scope + "\n"
   + HashSHA256(canonical_request.Encode("utf-8")).HexDigest()

署名を計算します。これを行うには、 AWS シークレットアクセスキーから署名キーを取得します。保護レベルを高めるために、派生キーは日付、サービス、 AWS リージョンに固有になっています。派生キーを使用して、リクエストに署名します。詳細については、「署名バージョン 4 AWS の署名を計算する」を参照してください。

GetSignatureKey 関数を実装して署名キーを取得します。まだ署名キーを取得していない場合は、「署名バージョン 4 の署名キーを取得する方法の例」を参照してください。

#Create the signing key
signing_key = GetSignatureKey(secret_key, datestamp, region, service)
                
# Sign the string_to_sign using the signing key
signature = HMAC.new(signing_key, (string_to_sign).Encode("utf-8"), Sha256()).HexDigest

関数は、バイナリ形式で結果を返す HMAC-SHA256 関数HMAC(key, data)を表します。

リクエストに署名情報を追加し、リクエスト を作成しますURL。

署名を計算したら、クエリ文字列に追加します。詳細については、「署名をリクエストに追加する」を参照してください。

まず、クエリ文字列に認証情報を追加します。

canonical_querystring += "&X-Amz-Signature=" + signature

次に、リクエストURLの を作成します。

request_url = endpoint + canonical_uri + "?" + canonical_querystring

WebSocket ライブラリURLで リクエストを使用して、 にリクエストを行います Amazon Transcribe。

へのリクエストには、次のヘッダーを含める Amazon Transcribe 必要があります。通常、これらのヘッダーは WebSocket クライアントライブラリによって管理されます。

Host: transcribestreaming.us-west-2.amazonaws.com:8443
Connection: Upgrade
Upgrade: websocket
Origin: URI-of-WebSocket-client
Sec-WebSocket-Version: 13
Sec-WebSocket-Key: randomly-generated-string

は WebSocket リクエスト Amazon Transcribe を受け取ると、アップグレードレスポンスで WebSocket 応答します。通常、 WebSocket ライブラリはこのレスポンスを管理し、通信用のソケットを設定します Amazon Transcribe。

以下は、 からのレスポンスです Amazon Transcribe。読みやすくするために、改行が追加されています。

HTTP/1.1 101 WebSocket Protocol Handshake

Connection: upgrade
Upgrade: websocket
websocket-origin: wss://transcribestreaming.us-west-2.amazonaws.com:8443
websocket-location: transcribestreaming.us-west-2.amazonaws.com:8443/stream-transcription-websocket?
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20220208%2Fus-west-2%2Ftranscribe%2Faws4_request
&X-Amz-Date=20220208T235959Z
&X-Amz-Expires=300
&X-Amz-Signature=Signature Version 4 signature
&X-Amz-SignedHeaders=host
&language-code=en-US
&session-id=String
&media-encoding=flac
&sample-rate=16000
x-amzn-RequestId: RequestId
Strict-Transport-Security: max-age=31536000
sec-websocket-accept: hash-of-the-Sec-WebSocket-Key-header

WebSocket ストリーミングリクエストを行います。

WebSocket 接続が確立されると、クライアントは一連のオーディオフレームの送信を開始できます。各フレームはイベントストリームエンコードを使用してエンコードされます。

各データフレームには、未加工の音声バイトのチャンクと組み合わせた 3 つのヘッダーが含まれています。以下の表はこれらのヘッダーについて説明したものです。

データストリームを終了するには、空の音声チャンクをイベントストリームでエンコードされたメッセージで送信します。

レスポンスには、イベントストリームでエンコードされた raw バイトがペイロードに含まれています。また、標準の prelude と以下のヘッダーが含まれます。

バイナリレスポンスをデコードすると、文字起こし結果を含むJSON構造になります。