使用 Docker 的語音轉換文字容器
語音轉換文字容器會謄寫具有中繼結果的即時語音或批次音訊錄製內容。 在本文中，您將瞭解如何下載、安裝及執行語音轉換文字容器。
如需必要條件、驗證容器正在執行、在相同主機上執行多個容器，以及執行中斷連線容器的詳細資訊，請參閱使用 Docker 安裝及執行語音容器。
容器映像
您可以在 Microsoft Container Registry (MCR) 同步發行中找到所有支援版本和地區設定的語音轉換文字容器映像。 其位於 azure-cognitive-services/speechservices/ 存放庫內，並命名為 speech-to-text。
完整的容器映像名稱為 mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text。 附加特定版本或附加 :latest 以取得最新版本。
| 版本 | Path |
|---|---|
| 最新 | mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latestlatest 標記會提取 en-US 地區設定的最新映像。 |
| 4.10.0 | mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:4.10.0-amd64-mr-in |
除了 latest 以外的所有標籤都採用下列格式，而且會區分大小寫：
<major>.<minor>.<patch>-<platform>-<locale>-<prerelease>
為了方便起見，標籤也以 JSON 格式提供。 本文包含容器路徑和標籤清單。 標籤不會依版本排序，但 "latest" 一律會包含在清單結尾，如下列程式碼片段所示：
{
"name": "azure-cognitive-services/speechservices/speech-to-text",
"tags": [
<--redacted for brevity-->
"4.10.0-amd64-sw-tz",
"4.10.0-amd64-ta-in",
"4.10.0-amd64-th-th",
"4.10.0-amd64-tr-tr",
"4.10.0-amd64-vi-vn",
"4.10.0-amd64-wuu-cn",
"4.10.0-amd64-yue-cn",
"4.10.0-amd64-zh-cn",
"4.10.0-amd64-zh-cn-sichuan",
"4.10.0-amd64-zh-hk",
"4.10.0-amd64-zh-tw",
"4.10.0-amd64-zu-za",
"latest"
]
}
使用 docker pull 取得容器映像
您需要必要條件，包括必要的硬體。 另請參閱每個語音容器的建議資源配置。
使用 docker pull 命令，從 Microsoft Container Registry下載容器映像：
docker pull mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text:latest
重要
latest 標記會提取 en-US 地區設定的最新映像。 如需其他版本和地區設定，請參閱語音轉換文字容器映像。
使用 docker run 執行容器
將 docker run 命令執行容器。
下表代表各種 docker run 參數及其對應的描述：
| 參數 | 描述 |
|---|---|
{ENDPOINT_URI} |
計量和帳單需要端點。 如需詳細資訊，請參閱計費引數。 |
{API_KEY} |
API 金鑰是必要的。 如需詳細資訊，請參閱計費引數。 |
當您執行語音轉換文字容器時，請根據語音轉換文字容器需求和建議，設定連接埠、記憶體和 CPU。
以下為具有預留位置值的範例 docker run 命令。 您必須指定 ENDPOINT_URI 和 API_KEY 值：
docker run --rm -it -p 5000:5000 --memory 8g --cpus 4 \
mcr.microsoft.com/azure-cognitive-services/speechservices/speech-to-text \
Eula=accept \
Billing={ENDPOINT_URI} \
ApiKey={API_KEY}
此命令：
- 從容器映像執行
speech-to-text容器。 - 配置 4 個 CPU 核心和 8 GB 的記憶體。
- 公開 TCP 通訊埠 5000，並為容器配置虛擬 TTY。
- 在容器結束之後自動將其移除。 容器映像仍可在主機電腦上使用。
如需關於搭配語音容器執行 docker run 的詳細資訊，請參閱使用 Docker 安裝及執行語音容器。
使用該容器
語音容器會提供 Websocket 型查詢端點 API，其可透過語音 SDK 和語音 CLI 來存取。 根據預設，語音 SDK 和語音 CLI 會使用公用語音服務。 若要使用容器，您必須變更初始化方法。
重要
當您搭配容器使用語音服務時，請務必使用主機驗證。 如果您設定金鑰和區域，則要求會移至公用語音服務。 來自語音服務的結果可能並非如您預期的結果。 來自已中斷連線容器的要求將會失敗。
不要使用此 Azure 雲端初始化設定：
var config = SpeechConfig.FromSubscription(...);
搭配容器主機使用此設定：
var config = SpeechConfig.FromHost(
new Uri("ws://localhost:5000"));
不要使用此 Azure 雲端初始化設定：
auto speechConfig = SpeechConfig::FromSubscription(...);
搭配容器主機使用此設定：
auto speechConfig = SpeechConfig::FromHost("ws://localhost:5000");
不要使用此 Azure 雲端初始化設定：
speechConfig, err := speech.NewSpeechConfigFromSubscription(...)
搭配容器主機使用此設定：
speechConfig, err := speech.NewSpeechConfigFromHost("ws://localhost:5000")
不要使用此 Azure 雲端初始化設定：
SpeechConfig speechConfig = SpeechConfig.fromSubscription(...);
搭配容器主機使用此設定：
SpeechConfig speechConfig = SpeechConfig.fromHost("ws://localhost:5000");
不要使用此 Azure 雲端初始化設定：
const speechConfig = sdk.SpeechConfig.fromSubscription(...);
搭配容器主機使用此設定：
const speechConfig = sdk.SpeechConfig.fromHost("ws://localhost:5000");
不要使用此 Azure 雲端初始化設定：
SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithSubscription:...];
搭配容器主機使用此設定：
SPXSpeechConfiguration *speechConfig = [[SPXSpeechConfiguration alloc] initWithHost:"ws://localhost:5000"];
不要使用此 Azure 雲端初始化設定：
let speechConfig = SPXSpeechConfiguration(subscription: "", region: "");
搭配容器主機使用此設定：
let speechConfig = SPXSpeechConfiguration(host: "ws://localhost:5000");
不要使用此 Azure 雲端初始化設定：
speech_config = speechsdk.SpeechConfig(
subscription=speech_key, region=service_region)
搭配容器端點使用此設定：
speech_config = speechsdk.SpeechConfig(
host="ws://localhost:5000")
當您在容器中使用語音 CLI 時，請包含 --host ws://localhost:5000/ 選項。 您也必須指定 --key none 來確保 CLI 不會嘗試使用語音金鑰進行驗證。 如需如何設定語音 CLI 的詳細資訊，請參閱開始使用 Azure AI 語音 CLI。
使用主機驗證而非金鑰和區域，嘗試語音轉換文字快速入門。
下一步
- 請參閱語音容器概觀
- 檢閱設定容器以了解組態設定
- 使用更多 Azure AI 容器