本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # StartCallAnalyticsStreamTranscription 啟動雙向 HTTP/2 或 WebSocket 串流，其中音訊會串流至 Amazon Transcribe，而且轉錄結果會串流至您的應用程式。使用此操作進行[通話分析](https://docs.aws.amazon.com/transcribe/latest/dg/call-analytics.html)轉錄。下列是必要參數： + `language-code` + `media-encoding` + `sample-rate` 如需使用 Amazon Transcribe 行串流的詳細資訊，請參閱[轉錄串流音](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html)訊。 ## 請求語法 ``` POST /call-analytics-stream-transcription HTTP/2 x-amzn-transcribe-language-code: LanguageCode x-amzn-transcribe-sample-rate: MediaSampleRateHertz x-amzn-transcribe-media-encoding: MediaEncoding x-amzn-transcribe-vocabulary-name: VocabularyName x-amzn-transcribe-session-id: SessionId x-amzn-transcribe-vocabulary-filter-name: VocabularyFilterName x-amzn-transcribe-vocabulary-filter-method: VocabularyFilterMethod x-amzn-transcribe-language-model-name: LanguageModelName x-amzn-transcribe-enable-partial-results-stabilization: EnablePartialResultsStabilization x-amzn-transcribe-partial-results-stability: PartialResultsStability x-amzn-transcribe-content-identification-type: ContentIdentificationType x-amzn-transcribe-content-redaction-type: ContentRedactionType x-amzn-transcribe-pii-entity-types: PiiEntityTypes Content-type: application/json { "AudioStream": { "AudioEvent": { "AudioChunk": blob }, "ConfigurationEvent": { "ChannelDefinitions": [ { "ChannelId": number, "ParticipantRole": "string" } ], "PostCallAnalyticsSettings": { "ContentRedactionOutput": "string", "DataAccessRoleArn": "string", "OutputEncryptionKMSKeyId": "string", "OutputLocation": "string" } } } } ``` ## URI 請求參數請求會使用下列 URI 參數。 ** [ContentIdentificationType](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 標記您轉錄單中所有個人身分識別資訊 (PII) 中識別資訊 (PII)。內容識別是在區段層級執行；中指定的 PII 會`PiiEntityTypes`在完成音訊區段轉錄時加上旗標。您無法設置`ContentIdentificationType`並`ContentRedactionType`在相同的請求中。如果同時設定兩者，則您的請求會傳回一個`BadRequestException`. 如需詳細資訊，請參閱[編輯或識別個人識別資訊](https://docs.aws.amazon.com/transcribe/latest/dg/pii-redaction.html)。有效值：` PII` ** [ContentRedactionType](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 標記您轉錄單中所有個人身分識別資訊 (PII) 都區別資訊 (PII)。內容密文是在區段層級執行；中指定的 PII 會`PiiEntityTypes`在完成音訊區段轉錄時進行編輯。您無法設置`ContentRedactionType`並`ContentIdentificationType`在相同的請求中。如果同時設定兩者，則您的請求會傳回一個`BadRequestException`. 如需詳細資訊，請參閱[編輯或識別個人識別資訊](https://docs.aws.amazon.com/transcribe/latest/dg/pii-redaction.html)。有效值：` PII` ** [EnablePartialResultsStabilization](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 為轉錄啟用部分結果穩定功能。部分結果穩定可以減少輸出的延遲時間，但可能會影響準確性。如需詳細資訊，請參閱[局部結果穩定](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html#streaming-partial-result-stabilization)。 ** [LanguageCode](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定代表您音訊中所使用語言的語言代碼。如果您不確定音訊中所說的語言，請考慮使用啟`IdentifyLanguage`用自動語言識別功能。如需即時通話分析支援的語言清單，請參閱[支援的語言](https://docs.aws.amazon.com/transcribe/latest/dg/supported-languages.html)表格。有效值：` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR` 必要：是 ** [LanguageModelName](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定處理轉錄時要使用的自訂語言模型名稱。請注意，語言模型名稱稱稱稱稱稱稱稱稱，指定語言模型的語言必須符合您在轉錄要求中指定的語言代碼。如果語言不相符，則不會套用自訂語言模型。沒有與語言不匹配相關的錯誤或警告。如需詳細資訊，請參閱[自訂語言模型](https://docs.aws.amazon.com/transcribe/latest/dg/custom-language-models.html)。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ** [MediaEncoding](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定輸入音訊的編碼。支援的格式包括： + 弗拉克 + Ogg 容器中的 OPUS 編碼音頻 + PCM（僅簽名 16 位小端音頻格式，不包括 WAV）如需詳細資訊，請參閱[媒體格式](https://docs.aws.amazon.com/transcribe/latest/dg/how-input.html#how-input-audio)。有效值：` pcm | ogg-opus | flac` 必要：是 ** [MediaSampleRateHertz](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 輸入音訊的取樣率 (以赫茲為單位)。低質量的音頻，例如電話音頻，通常約為 8,000 Hz。高品質的音訊通常介於 16,000 赫茲至 48,000 赫茲之間。請注意，您指定的取樣率必須與音訊的取樣率相符。有效範圍：最小值為 8000。最大值為 48 000。必要：是 ** [PartialResultsStability](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定啟用局部結果穩定時要使用的穩定性等級 (`EnablePartialResultsStabilization`)。低穩定性提供最高的精度。高穩定性的轉錄速度更快，但準確度略低。如需詳細資訊，請參閱[局部結果穩定](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html#streaming-partial-result-stabilization)。有效值：` high | medium | low` ** [PiiEntityTypes](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定您要在成績單中編輯的個人識別資訊 (PII) 類型。您可以根據需要包含任意數量的類型，也可以選擇`ALL`。若要包含`PiiEntityTypes`在您的通話分析要求中，您還必須包含`ContentIdentificationType`或`ContentRedactionType`。值必須以逗號分隔，且可以包括：`ADDRESS``BANK_ACCOUNT_NUMBER``BANK_ROUTING`、、`CREDIT_DEBIT_CVV`、`CREDIT_DEBIT_EXPIRY`、`CREDIT_DEBIT_NUMBER`、、`EMAIL`、`NAME`、`PHONE`、、`PIN`、`SSN`、、或`ALL`。長度限制：長度下限為 1。長度上限為 300。模式：`^[A-Z_, ]+` ** [SessionId](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 為您的呼叫分析轉錄工作階段指定名稱。如果您的請求中沒有包含此參數，Amazon Transcribe 會產生一個 ID 並在回應中傳回 ID。長度限制：固定長度為 36。模式：`[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` ** [VocabularyFilterMethod](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定您希望詞彙篩選條件套用至成績單的方式。若要取代文字`***`，請選擇`mask`。若要刪除單字，請選擇`remove`。若要標記文字而不變更它們，請選擇`tag`。有效值：` remove | mask | tag` ** [VocabularyFilterName](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定處理轉錄時要使用的自訂字彙篩選器名稱。請注意，字彙篩選名稱稱稱稱稱稱稱稱稱稱如果指定的自訂字彙篩選器的語言與媒體中識別的語言不符，則字彙篩選條件不會套用至您的轉錄。如需詳細資訊，請參閱[使用字彙篩選搭配不想要的字詞](https://docs.aws.amazon.com/transcribe/latest/dg/vocabulary-filtering.html)。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ** [VocabularyName](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 指定處理轉錄時要使用的自訂字彙名稱。請注意，字彙名稱稱稱稱稱稱稱稱稱稱如果指定自訂字彙的語言與您的媒體中識別的語言不相符，則自訂字彙不會套用至您的轉錄。如需詳細資訊，請參閱[自訂字彙](https://docs.aws.amazon.com/transcribe/latest/dg/custom-vocabulary.html)。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ## 請求主體請求接受採用 JSON 格式的下列資料。 ** [AudioStream](#API_streaming_StartCallAnalyticsStreamTranscription_RequestSyntax) ** 音頻斑點的編碼流。音頻流被編碼為 HTTP/2 或 WebSocket 數據幀。如需詳細資訊，請參[閱轉錄串流音](https://docs.aws.amazon.com/transcribe/latest/dg/streaming.html)訊。類型：[CallAnalyticsAudioStream](API_streaming_CallAnalyticsAudioStream.md) 物件必要：是 ## 回應語法 ``` HTTP/2 200 x-amzn-request-id: RequestId x-amzn-transcribe-language-code: LanguageCode x-amzn-transcribe-sample-rate: MediaSampleRateHertz x-amzn-transcribe-media-encoding: MediaEncoding x-amzn-transcribe-vocabulary-name: VocabularyName x-amzn-transcribe-session-id: SessionId x-amzn-transcribe-vocabulary-filter-name: VocabularyFilterName x-amzn-transcribe-vocabulary-filter-method: VocabularyFilterMethod x-amzn-transcribe-language-model-name: LanguageModelName x-amzn-transcribe-enable-partial-results-stabilization: EnablePartialResultsStabilization x-amzn-transcribe-partial-results-stability: PartialResultsStability x-amzn-transcribe-content-identification-type: ContentIdentificationType x-amzn-transcribe-content-redaction-type: ContentRedactionType x-amzn-transcribe-pii-entity-types: PiiEntityTypes Content-type: application/json { "CallAnalyticsTranscriptResultStream": { "BadRequestException": { }, "CategoryEvent": { "MatchedCategories": [ "string" ], "MatchedDetails": { "string" : { "TimestampRanges": [ { "BeginOffsetMillis": number, "EndOffsetMillis": number } ] } } }, "ConflictException": { }, "InternalFailureException": { }, "LimitExceededException": { }, "ServiceUnavailableException": { }, "UtteranceEvent": { "BeginOffsetMillis": number, "EndOffsetMillis": number, "Entities": [ { "BeginOffsetMillis": number, "Category": "string", "Confidence": number, "Content": "string", "EndOffsetMillis": number, "Type": "string" } ], "IsPartial": boolean, "IssuesDetected": [ { "CharacterOffsets": { "Begin": number, "End": number } } ], "Items": [ { "BeginOffsetMillis": number, "Confidence": number, "Content": "string", "EndOffsetMillis": number, "Stable": boolean, "Type": "string", "VocabularyFilterMatch": boolean } ], "ParticipantRole": "string", "Sentiment": "string", "Transcript": "string", "UtteranceId": "string" } } } ``` ## 回應元素如果動作成功，則服務傳回 HTTP 200 回應。回應會傳回下列 HTTP 標頭。 ** [ContentIdentificationType](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 顯示您的通話分析轉錄是否啟用內容識別功能。有效值：` PII` ** [ContentRedactionType](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 顯示是否已針對您的通話分析轉錄啟用內容編輯。有效值：` PII` ** [EnablePartialResultsStabilization](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 顯示您的通話分析轉錄是否已啟用部分結果穩定功能。 ** [LanguageCode](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在呼叫分析要求中指定的語言代碼。有效值：` en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR` ** [LanguageModelName](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在呼叫分析要求中指定的自訂語言模型名稱。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ** [MediaEncoding](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在呼叫分析要求中指定的媒體編碼。有效值：` pcm | ogg-opus | flac` ** [MediaSampleRateHertz](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在呼叫分析要求中指定的取樣率。有效範圍：最小值為 8000。最大值為 48 000。 ** [PartialResultsStability](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供用於轉錄的穩定級別。有效值：` high | medium | low` ** [PiiEntityTypes](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 列出您在呼叫分析要求中指定的 PII 實體類型。長度限制：長度下限為 1。長度上限為 300。模式：`^[A-Z_, ]+` ** [RequestId](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 為您的即時通話分析要求提供識別碼。 ** [SessionId](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 為您的呼叫分析轉錄工作階段提供識別碼。長度限制：固定長度為 36。模式：`[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` ** [VocabularyFilterMethod](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供通話分析轉錄中使用的詞彙篩選方法。有效值：` remove | mask | tag` ** [VocabularyFilterName](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在「呼叫分析」請求中指定的自訂詞彙篩選器名稱。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` ** [VocabularyName](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供您在「呼叫分析」請求中指定的自訂詞彙名稱。長度限制：長度下限為 1。長度上限為 200。模式：`^[0-9a-zA-Z._-]+` 服務會傳回下列 JSON 格式的資料。 ** [CallAnalyticsTranscriptResultStream](#API_streaming_StartCallAnalyticsStreamTranscription_ResponseSyntax) ** 提供有關即時通話分析工作階段的詳細資訊。類型：[CallAnalyticsTranscriptResultStream](API_streaming_CallAnalyticsTranscriptResultStream.md) 物件 ## 錯誤如需所有動作常見的錯誤相關資訊，請參閱[常見錯誤](CommonErrors.md)。 ** BadRequestException ** `StartStreamTranscription`、`StartMedicalStreamTranscription`或`StartCallAnalyticsStreamTranscription`作業的一或多個引數無效。例如，`MediaEncoding`或`LanguageCode`使用不支持的值。請檢查指定的參數，然後再試一次。 HTTP 狀態碼：400 ** ConflictException ** 以相同工作階段 ID 開始的新串流。目前的串流已終止。 HTTP 狀態碼：409 ** InternalFailureException ** 處理音訊時發生問題。Amazon Transcribe 終止處理。 HTTP 狀態碼：500 ** LimitExceededException ** 您的客戶已超過 Amazon 轉錄限制之一。這通常是音頻長度限制。將您的音訊串流分成較小的區塊，然後再次嘗試您的要求。 HTTP 狀態碼：429 ** ServiceUnavailableException ** 此服務目前無法使用。請稍後再試您的要求。 HTTP 狀態碼：503 ## 另請參閱如需在語言特定的 AWS 開發套件之一中使用此 API 的詳細資訊，請參閱下列說明： + [AWS 命令列界面](https://docs.aws.amazon.com/goto/aws-cli/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 .NET 的 AWS 開發套件](https://docs.aws.amazon.com/goto/DotNetSDKV3/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 C\$1\$1 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForCpp/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 Go 的 AWS 開發套件](https://docs.aws.amazon.com/goto/SdkForGoV1/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 Java 的 AWS 開發套件第 2 版](https://docs.aws.amazon.com/goto/SdkForJavaV2/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [AWS適用於的 SDK JavaScript](https://docs.aws.amazon.com/goto/AWSJavaScriptSDK/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 PHP 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForPHPV3/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 Python 的 AWS 開發套件](https://docs.aws.amazon.com/goto/boto3/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription) + [適用於 Ruby 的 AWS 開發套件第 3 版](https://docs.aws.amazon.com/goto/SdkForRubyV3/transcribe-streaming-2017-10-26/StartCallAnalyticsStreamTranscription)