本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
StartStreamTranscription
啟動雙向 HTTP/2，其中音訊會 WebSocket 串流至 Amazon Transcribe，而且轉錄結果會串流至您的應用程式。
下列是必要參數：
-
language-code或identify-language -
media-encoding -
sample-rate
如需使用 Amazon Transcribe 行串流的詳細資訊，請參閱轉錄串流音訊。
請求語法
POST /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-show-speaker-label: ShowSpeakerLabel
x-amzn-transcribe-enable-channel-identification: EnableChannelIdentification
x-amzn-transcribe-number-of-channels: NumberOfChannels
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
x-amzn-transcribe-language-model-name: LanguageModelName
x-amzn-transcribe-identify-language: IdentifyLanguage
x-amzn-transcribe-language-options: LanguageOptions
x-amzn-transcribe-preferred-language: PreferredLanguage
x-amzn-transcribe-vocabulary-names: VocabularyNames
x-amzn-transcribe-vocabulary-filter-names: VocabularyFilterNames
Content-type: application/json
{
"AudioStream": {
"AudioEvent": {
"AudioChunk": blob
}
}
}URI 請求參數
請求會使用下列 URI 參數。
- ContentIdentificationType
-
為您的轉錄單中所有個人身分識別資訊 (PII)。
內容識別是在區段層級執行；中指定的 PII 會
PiiEntityTypes在完成音訊區段轉錄時加上旗標。您無法設置
ContentIdentificationType並ContentRedactionType在相同的請求中。如果同時設定兩者，則您的請求會傳回一個BadRequestException.如需詳細資訊，請參閱編輯或識別個人識別資訊。
有效值：
PII - ContentRedactionType
-
刪除您的轉錄單中所有個人身分識別資訊 (PII)。
內容密文是在區段層級執行；中指定的 PII 會
PiiEntityTypes在完成音訊區段轉錄時進行編輯。您無法設置
ContentRedactionType並ContentIdentificationType在相同的請求中。如果同時設定兩者，則您的請求會傳回一個BadRequestException.如需詳細資訊，請參閱編輯或識別個人識別資訊。
有效值：
PII - EnableChannelIdentification
-
啟用多聲道音訊中的頻道識別。
頻道識別會分別轉錄每個聲道上的音訊，然後將每個頻道的輸出附加到一個文字記錄中。
如果您有多聲道音訊，但未啟用頻道識別功能，您的音訊會以連續的方式進行轉錄，而且您的文字記錄不會被頻道隔開。
如果您的請求
EnableChannelIdentification中，則必須也包含NumberOfChannels。如需詳細資訊，請參閱轉錄多聲道音訊。
- EnablePartialResultsStabilization
-
為轉錄啟用部分結果穩定功能。部分結果穩定可以減少輸出的延遲時間，但可能會影響準確性。如需詳細資訊，請參閱局部分結果穩定。
- IdentifyLanguage
-
為您的轉錄啟用自動語言識別。
如果您包含
IdentifyLanguage，則可以選擇包括語言代碼列表LanguageOptions，使用，您認為可能存在於音頻流中。包括語言選項可以提高轉錄準確性。您也可以使用
PreferredLanguage。新增慣用語言可協助 Amazon Transcribe 識別語言的速度，比省略此參數的速度更快。如果您在每個頻道上都有不同語言的多聲道音訊，並且您已啟用頻道識別功能，則自動語言識別功能會識別每個音訊頻道上的主要語言。
請注意，您必須在請求
IdentifyLanguage中包含LanguageCode或。如果同時包含這兩個參數，您的要求就會失敗。串流語言識別無法與自訂語言模型或編輯結合使用。
- LanguageCode
-
指定代表您音訊中所使用語言的語言代碼。
如果您不確定音訊中所說的語言，請考慮使用啟
IdentifyLanguage用自動語言識別功能。如需 Amazon Transcribe 串流支援的語言清單，請參閱支援的語言表。
有效值：
en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH - LanguageModelName
-
指定處理轉錄時要使用的自訂語言模型名稱。請注意，語言模型號。
指定語言模型的語言必須符合您在轉錄要求中指定的語言代碼。如果語言不相符，則不會套用自訂語言模型。沒有與語言不匹配相關的錯誤或警告。
如需詳細資訊，請參閱自訂語言模型。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - LanguageOptions
-
指定代表您認為媒體中可能存在的語言的兩個或兩個以上的語言代碼；不建議包括五個以上的語言代碼。如果您不確定存在哪些語言，請不要包含此參數。
包括語言選項可以提高語言識別的準確性。
如果您的請求
LanguageOptions中，則必須也包含IdentifyLanguage。如需 Amazon Transcribe 串流支援的語言清單，請參閱支援的語言表。
重要
每個串流只能包含一種語言。例如，您不能在相同的請求
en-AU中包含en-US和。長度限制：長度下限為 1。長度上限為 200。
模式：
^[a-zA-Z-,]+ - MediaEncoding
-
指定輸入音訊的編碼。支援的格式包括：
-
弗拉克
-
Ogg 容器中的 OPUS 編碼音頻
-
PCM（僅簽名 16 位小端音頻格式，不包括 WAV）
如需詳細資訊，請參閱媒體格式。
有效值：
pcm | ogg-opus | flac必要：是
-
- MediaSampleRateHertz
-
輸入音訊的取樣率 (以赫茲為單位)。低質量的音頻，例如電話音頻，通常約為 8,000 Hz。高品質的音訊通常介於 16,000 赫茲至 48,000 赫茲之間。請注意，您指定的取樣率必須與音訊的取樣率相符。
有效範圍：最小值為 8000。最大值為 48000。
必要：是
- NumberOfChannels
-
指定音訊串流中的頻道。此值必須是
2，因為僅支援兩個通道。如果您的音訊不包含多個頻道，請勿在要求中加入此參數。如果您的請求
NumberOfChannels中，則必須也包含EnableChannelIdentification。有效範圍：最小值為 2。
- PartialResultsStability
-
指定啟用局部結果穩定時要使用的穩定性等級 (
EnablePartialResultsStabilization)。低穩定性提供最高的精度。高穩定性的轉錄速度更快，但精度略低。
如需詳細資訊，請參閱局部分結果穩定。
有效值：
high | medium | low - PiiEntityTypes
-
指定您要在成績單中編輯的個人識別資訊 (PII) 類型。您可以根據需要包含任意數量的類型，也可以選擇
ALL。若要包含
PiiEntityTypes在您的請求中，您還必須包含ContentIdentificationType或ContentRedactionType。值必須以逗號分隔，且可以包括：
ADDRESSBANK_ACCOUNT_NUMBERBANK_ROUTING、、CREDIT_DEBIT_CVV、CREDIT_DEBIT_EXPIRY、CREDIT_DEBIT_NUMBER、、EMAIL、NAME、PHONE、、PIN、SSN、、或ALL。長度限制：長度下限為 1。長度上限為 300。
模式：
^[A-Z_, ]+ - PreferredLanguage
-
從您在中指定的語言代碼子集中指定偏好的語言
LanguageOptions。您只能使用此參數，如果您已包含
IdentifyLanguage並LanguageOptions在您的請求中。有效值：
en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH - SessionId
-
指定轉錄工作階段的名稱。如果您的請求中沒有包含此參數，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} - ShowSpeakerLabel
-
在轉錄輸出中啟用揚聲器分區（日記）。喇叭分割會標示媒體檔案中個別發言者的語音。
如需詳細資訊，請參閱分割喇叭 (日記)。
- VocabularyFilterMethod
-
指定您希望詞彙篩選條件套用至成績單的方式。
若要取代文字
***，請選擇mask。若要刪除單字，請選擇
remove。若要標記文字而不變更它們，請選擇
tag。有效值：
remove | mask | tag - VocabularyFilterName
-
指定處理轉錄時要使用的自訂字彙篩選器名稱。請注意，字彙篩選器大小寫。
如果指定的自訂字彙篩選器的語言與媒體中識別的語言不符，則字彙篩選條件不會套用至您的轉錄。
重要
此參數不適用於與
IdentifyLanguage參數搭配使用。如果您要包含IdentifyLanguage在請求中，並且想要在轉錄中使用一或多個詞彙篩選器，請改用VocabularyFilterNames參數。如需詳細資訊，請參閱使用字彙篩選搭配不想要的字詞。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyFilterNames
-
指定處理轉錄時要使用的自訂字彙篩選器名稱。請注意，字彙篩選器大小寫。
如果指定的自訂字彙篩選條件中沒有任何語言符合您的媒體識別的語言，則工作會失敗。
重要
此參數僅適用於與
IdentifyLanguage參數搭配使用。如果您沒有包含IdentifyLanguage在要求中，而且想要在轉錄中使用自訂字彙篩選器，請改用VocabularyFilterName參數。如需詳細資訊，請參閱使用字彙篩選搭配不想要的字詞。
長度限制：長度下限為 1。長度上限為 3000。
模式：
^[a-zA-Z0-9,-._]+ - VocabularyName
-
指定處理轉錄時要使用的自訂字彙名稱。請注意，字彙。
如果指定自訂字彙的語言與您的媒體中識別的語言不相符，則自訂字彙不會套用至您的轉錄。
重要
此參數不適用於與
IdentifyLanguage參數搭配使用。如果您要IdentifyLanguage在要求中加入，並且想要在轉錄中使用一或多個自訂詞彙，請改用VocabularyNames參數。如需詳細資訊，請參閱自訂字彙。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyNames
-
指定處理轉錄時要使用的自訂字彙名稱。請注意，字彙。
如果指定的自訂字彙中沒有任何語言符合您的媒體中識別的語言，您的工作就會失敗。
重要
此參數僅適用於與
IdentifyLanguage參數搭配使用。如果您沒有在要求IdentifyLanguage中包含，而且想要在轉錄中使用自訂字彙，請改用VocabularyName參數。如需詳細資訊，請參閱自訂字彙。
長度限制：長度下限為 1。長度上限為 3000。
模式：
^[a-zA-Z0-9,-._]+
請求主體
請求接受採用 JSON 格式的下列資料。
- AudioStream
-
音頻斑點的編碼流。音頻流被編碼為 HTTP/2 或 WebSocket 數據幀。
如需詳細資訊，請參閱轉錄串流音訊。
類型：AudioStream 物件
必要：是
回應語法
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-show-speaker-label: ShowSpeakerLabel
x-amzn-transcribe-enable-channel-identification: EnableChannelIdentification
x-amzn-transcribe-number-of-channels: NumberOfChannels
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
x-amzn-transcribe-language-model-name: LanguageModelName
x-amzn-transcribe-identify-language: IdentifyLanguage
x-amzn-transcribe-language-options: LanguageOptions
x-amzn-transcribe-preferred-language: PreferredLanguage
x-amzn-transcribe-vocabulary-names: VocabularyNames
x-amzn-transcribe-vocabulary-filter-names: VocabularyFilterNames
Content-type: application/json
{
"TranscriptResultStream": {
"BadRequestException": {
},
"ConflictException": {
},
"InternalFailureException": {
},
"LimitExceededException": {
},
"ServiceUnavailableException": {
},
"TranscriptEvent": {
"Transcript": {
"Results": [
{
"Alternatives": [
{
"Entities": [
{
"Category": "string",
"Confidence": number,
"Content": "string",
"EndTime": number,
"StartTime": number,
"Type": "string"
}
],
"Items": [
{
"Confidence": number,
"Content": "string",
"EndTime": number,
"Speaker": "string",
"Stable": boolean,
"StartTime": number,
"Type": "string",
"VocabularyFilterMatch": boolean
}
],
"Transcript": "string"
}
],
"ChannelId": "string",
"EndTime": number,
"IsPartial": boolean,
"LanguageCode": "string",
"LanguageIdentification": [
{
"LanguageCode": "string",
"Score": number
}
],
"ResultId": "string",
"StartTime": number
}
]
}
}
}
}回應元素
如果動作成功，則服務傳回 HTTP 200 回應。
回應會傳回下列 HTTP 標頭。
- ContentIdentificationType
-
顯示您的轉錄是否啟用內容識別功能。
有效值：
PII - ContentRedactionType
-
顯示您的轉錄是否已啟用內容密文。
有效值：
PII - EnableChannelIdentification
-
顯示您的轉錄是否啟用頻道識別功能。
- EnablePartialResultsStabilization
-
顯示您的轉錄是否已啟用部分結果穩定功能。
- IdentifyLanguage
-
顯示您的轉錄是否已啟用自動語言識別功能。
- LanguageCode
-
提供您在請求中指定的語言代碼。
有效值：
en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH - LanguageModelName
-
提供您在請求中指定的自訂語言模型名稱。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - LanguageOptions
-
提供您在請求中指定的語言代碼。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[a-zA-Z-,]+ - MediaEncoding
-
提供您在要求中指定的媒體編碼。
有效值：
pcm | ogg-opus | flac - MediaSampleRateHertz
-
提供您在請求中指定的取樣率。
有效範圍：最小值為 8000。最大值為 48000。
- NumberOfChannels
-
提供您在請求中指定的通道數量。
有效範圍：最小值為 2。
- PartialResultsStability
-
提供用於轉錄的穩定級別。
有效值：
high | medium | low - PiiEntityTypes
-
列出您在請求中指定的 PII 實體類型。
長度限制：長度下限為 1。長度上限為 300。
模式：
^[A-Z_, ]+ - PreferredLanguage
-
提供您在請求中指定的偏好語言。
有效值：
en-US | en-GB | es-US | fr-CA | fr-FR | en-AU | it-IT | de-DE | pt-BR | ja-JP | ko-KR | zh-CN | hi-IN | th-TH - RequestId
-
提供串流要求的識別碼。
- SessionId
-
提供轉錄工作階段的識別碼。
長度限制：固定長度為 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} - ShowSpeakerLabel
-
顯示是否已為您的轉錄啟用喇叭分割。
- VocabularyFilterMethod
-
提供轉錄中使用的詞彙篩選方法。
有效值：
remove | mask | tag - VocabularyFilterName
-
提供您在請求中指定的自訂字彙篩選器名稱。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyFilterNames
-
提供您在請求中指定的自訂字彙篩選器名稱。
長度限制：長度下限為 1。長度上限為 3000。
模式：
^[a-zA-Z0-9,-._]+ - VocabularyName
-
提供您在請求中指定的自訂字彙的名稱。
長度限制：長度下限為 1。長度上限為 200。
模式：
^[0-9a-zA-Z._-]+ - VocabularyNames
-
提供您在請求中指定的自訂詞彙名稱。
長度限制：長度下限為 1。長度上限為 3000。
模式：
^[a-zA-Z0-9,-._]+
服務會傳回下列 JSON 格式的資料。
- TranscriptResultStream
-
提供串流工作階段的詳細資訊。
類型：TranscriptResultStream 物件
錯誤
如需所有動作常見的錯誤相關資訊，請參閱常見錯誤。
- 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 的詳細資訊，請參閱下列說明：
